الأدلة والشروحات

إعداد خطوة بخطوة لكل مسار تكامل.

بداية سريعة

ثلاث خطوات حتى أول نص:

1. سجّل على subdownload.com/account للحصول على 1000 رصيد مجاني.
2. انسخ مفتاح API (يبدأ بـ sk_live_).
3. اتصل بالواجهة مع المفتاح في ترويسة Authorization.

curl -H "Authorization: Bearer sk_live_xxx" \
  "https://api.subdownload.com/v1/youtube/transcript?video_id=dQw4w9WgXcQ"

import requests

API_KEY = "sk_live_xxx"
BASE = "https://api.subdownload.com/v1"

r = requests.get(
    f"{BASE}/youtube/transcript",
    params={"video_id": "dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
r.raise_for_status()
data = r.json()
print(data["data"]["text"][:200])

const API_KEY = "sk_live_xxx";

const res = await fetch(
  "https://api.subdownload.com/v1/youtube/transcript?video_id=dQw4w9WgXcQ",
  { headers: { Authorization: "Bearer " + API_KEY } }
);
if (!res.ok) throw new Error("HTTP " + res.status);
const data = await res.json();
console.log(data.data.text.slice(0, 200));

// لا تضع مفتاح API ثابتًا في كود العميل.
// مرّره عبر وكيل على خادمك الخاص.
const res = await fetch("/api/my-proxy/transcript?video_id=dQw4w9WgXcQ");
const data = await res.json();
console.log(data);

المصادقة

جميع طلبات الواجهة تحتاج إلى رمز Bearer في ترويسة Authorization:

Authorization: Bearer sk_live_xxxxx

• • مفاتيح API تبدأ بـ sk_live_.
• • لا تنتهي صلاحية المفاتيح إلا بإلغائها أو إعادة توليدها يدويًا.
• • احتفظ بالمفاتيح في متغيّرات البيئة — لا تضعها في كود العميل أو المستودعات العامة.
• • أدِر المفاتيح على subdownload.com/account.

تحقّق من المفتاح: GET /v1/verify (مجاني، بدون استهلاك أرصدة).

إعداد Claude (Desktop / Code)

Claude يدعم OAuth مع Dynamic Client Registration — لا تحتاج اعتمادات مُنشأة مسبقًا.

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp"
    }
  }
}

سيفتح Claude متصفحًا للتفويض، وتُحدَّث الرموز تلقائيًا.

أو استخدم مفتاح API ثابتًا (دون OAuth):

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_xxx" }
    }
  }
}

ChatGPT (GPT Actions / Custom Connectors)

يستخدم ChatGPT عملاء OAuth ثابتين. الخطوات:

1. ادخل إلى حسابك → تبويب MCP / OAuth.
2. انسخ Client ID وClient Secret.
3. في ChatGPT أضِف Connector / Action جديدًا مع:
   • MCP URL: https://api.subdownload.com/mcp
   • المصادقة: OAuth بـ Client ID وSecret الخاصة بك

OpenAI Agent Builder

الصق مفتاح API مباشرة كطريقة مصادقة (Bearer token). عنوان الخادم هو https://api.subdownload.com/mcp.