إرسال طلبات الدردشة باستخدام OAuth
استخدم رمز وصول OAuth المعتمد من ShareAI لإكمالات المحادثة الممولة من العميل وتعامل مع انتهاء صلاحية الرمز، الموافقة وحدود الحساب.
في هذه الصفحة
اختر هذا المسار عندما يقوم العميل بتفويض تطبيقك لاستخدام حساب ShareAI الذي اختاره. أكمل أولاً رمز التفويض باستخدام PKCE واحصل على منحة تتضمن surcharge.
https://api.shareai.now/api/v1/chat/completionsتشغيل الاستدلال بموجب اتفاقية التطبيق المقبولة من العميل.
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- رمز وصول OAuth الحامل
- النطاق المطلوب
surcharge
cURL
curl --fail-with-body https://api.shareai.now/api/v1/chat/completions \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{"model":"MODEL_IDENTIFIER","messages":[{"role":"user","content":"Hello!"}],"stream":false}'
يتم وضع رمز الوصول في ترويسة Bearer#
نقطة النهاية للدردشة وجسم الطلب هما نفس تدفق مفتاح API. الفرق هو بيانات الاعتماد ودورة حياة التفويض. يتم إرسال رمز التحديث فقط إلى نقطة نهاية الرمز؛ يتم استخدام رمز التعريف فقط لتسجيل الدخول إلى التطبيق الذي تم التحقق منه.
من يدفع وأي خطة تنطبق؟#
تحدد المنحة المقبولة الحساب الشخصي أو حساب المنظمة المختار، التطبيق وخطة الاستخدام. تحدد الخدمة هذه القيم من التفويض. لا ترسل معرف الدافع، رسوم Builder أو موضوع عميل آخر في جسم الدردشة لتغيير الفوترة.
تجديد الوصول دون فقدان الموافقة#
عندما تنتهي صلاحية رمز الوصول، استخدم تدفق التحديث على الخادم الخلفي الخاص بك وقم بتخزين رمز التحديث البديل. عندما يتم إلغاء المنحة أو تتطلب موافقة جديدة، قم بإعادة الاتصال بالعميل من خلال تدفق المتصفح.
معالجة الفشل#
| النتيجة | الإجراء |
|---|---|
401 consent_required | اطلب من العميل إعادة الاتصال إذا لم يعد التفويض صالحًا. |
403 | تحقق من إذن الاستدلال الممنوح والوصول إلى النموذج/المزود المسموح به. |
429 | احترم Retry-After وحدود التطبيق/الحساب الخاص بك. |
503 temporarily_unavailable | أظهر خطأ خدمة مؤقت؛ لا تخبر العميل أن الموافقة قد تم إلغاؤها. |
آخر تحديث سبتمبر 15, 2026