المصادقة

تُخصم تكلفة مفاتيح API من حساب مالك المفتاح. ويتيح OAuth لكل مستخدم متصل استخدام أرصدته.

مفاتيح API#

استخدم مفتاح API على الخادم لحسابك، أو OAuth لحساب كل عميل. لا ترسل المفاتيح في المطالبات أو وسيطات الأدوات.

HTTP

Authorization: Bearer $TONG_API_KEY

البدء السريعأنشئ مفتاح API واختر نموذجًا واحصل على تسعير الطلب وتابع نتيجته.مرجع الأدواتتصفح جميع أدوات الإبداع ومخططات طلباتها.

اكتشاف OAuth#

تُخصم تكلفة مفاتيح API من حساب مالك المفتاح. ويتيح OAuth لكل مستخدم متصل استخدام أرصدته.

curl 'https://platform.tongai.io/.well-known/oauth-authorization-server'

الإعدادات

curl --version

HTTP

GET /.well-known/oauth-protected-resourceGET /.well-known/oauth-protected-resource/mcp

التفويض والموافقة#

يستخدم OAuth بروتوكول S256 PKCE ورابط إعادة توجيه مطابقًا وموردًا منفصلًا لـ REST أو MCP. تتم الموافقة داخل Tong، وتتغير رموز التحديث مع كل استخدام.

JSON

{  "response_type": "code",  "client_id": "https://your-app.example/oauth/client.json",  "redirect_uri": "https://your-app.example/oauth/callback",  "resource": "https://platform.tongai.io/mcp",  "scope": "catalog:read operations:read generation:write quotes:write credits:spend",  "code_challenge_method": "S256",  "code_challenge": "BASE64URL_SHA256_OF_VERIFIER",  "state": "RANDOM_SESSION_STATE"}

HTTP

code_expires_in: 60 secondsaccess_token_expires_in: 300 secondsrefresh_token_expires_in: 30 daystoken_endpoint_auth_method: noneclient_id_metadata_document_supported: true

GET /oauth/authorizeيستخدم OAuth بروتوكول S256 PKCE ورابط إعادة توجيه مطابقًا وموردًا منفصلًا لـ REST أو MCP. تتم الموافقة داخل Tong، وتتغير رموز التحديث مع كل استخدام.POST /oauth/tokenيستخدم OAuth بروتوكول S256 PKCE ورابط إعادة توجيه مطابقًا وموردًا منفصلًا لـ REST أو MCP. تتم الموافقة داخل Tong، وتتغير رموز التحديث مع كل استخدام.POST /oauth/revokeيستخدم OAuth بروتوكول S256 PKCE ورابط إعادة توجيه مطابقًا وموردًا منفصلًا لـ REST أو MCP. تتم الموافقة داخل Tong، وتتغير رموز التحديث مع كل استخدام.

الأذونات#

تتطلب الأدوات المدفوعة أيضًا credits:spend. صلاحيات الحذف منفصلة.

مرجع الأدواتتصفح جميع أدوات الإبداع ومخططات طلباتها.إعداد MCPاربط Tong في عميل MCP واسمح بالوصول إلى حسابك، ثم اكتشف أدوات الإبداع المسموح بها واستدعها.