المصادقة على واجهة برمجة التطبيقات للمزود
تمكين الوصول عن بُعد للمزود واستخدام UUID الخاص بالمزود ورمز وصول محدد النطاق لطلبات الكتالوج والتسعير.
في هذه الصفحة
يدير API الخاص بالمزود كتالوج الحساب الخاص بالمزود والتسعير. قم بإنشاء بيانات اعتماده في إعدادات المزود. هذه البيانات الاعتمادية منفصلة عن مفاتيح API الخاصة بالاستدلال وعن الرموز التي تم إنشاؤها لجهاز فردي.
إنشاء وصول#
- حدد مساحة العمل التي تمتلك المزود في Console.
- افتح إعدادات المزود وقم بتمكين الوصول عن بُعد.
- أنشئ رمز وصول مسمى للمزود واحفظ السر بأمان.
- استخدم UUID الخاص بالمزود كاسم مستخدم HTTP Basic والرمز ككلمة مروره.


https://api.shareai.now/api/v1/console/providerتحقق من الوصول على مستوى المزود.
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- HTTP Basic: UUID المزود ورمز وصول المزود
- النطاق المطلوب
provider_models:read
cURL
curl --fail-with-body --request GET \
"https://api.shareai.now/api/v1/console/provider" \
-u "$PROVIDER_UUID:$PROVIDER_ACCESS_TOKEN"
Python
import json
import os
import urllib.request
import base64
credentials = os.environ["PROVIDER_UUID"] + ":" + os.environ["PROVIDER_ACCESS_TOKEN"]
headers = {"Authorization": "Basic " + base64.b64encode(credentials.encode()).decode()}
request = urllib.request.Request('https://api.shareai.now/api/v1/console/provider', headers=headers, method='GET')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/console/provider";
const credentials = `${process.env.PROVIDER_UUID}:${process.env.PROVIDER_ACCESS_TOKEN}`;
const headers: Record = {
Authorization: `Basic ${Buffer.from(credentials).toString("base64")}`,
};
const response = await fetch(url, { method: "GET", headers });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
النطاقات المسماة#
| نطاق | العمليات المسموح بها |
|---|---|
provider_models:read | قراءة ملخص المزود، الكتالوج، تفاصيل النموذج ومعلومات التسوية المسموح بها. |
provider_models:write | تحديث تسعير النماذج المسموح بها وتكوين الكتالوج/المشاركة الاحتياطي المسموح به. |
provider_incentives:write | تغيير إعدادات حوافز المزود على المسار المدعوم. |
يتم التحقق من النطاقات للمسار وطريقة HTTP. يكشف رمز المزود الحالي عن النطاقات التي تم تكوينها؛ لا يمنح الرمز أبدًا ملكية مزود مختلف. ضع في اعتبارك حالة التمكين وحالة الرمز عند تشخيص استجابة 403.
التحكم في الجهاز هو طبقة أخرى#
بدء أو إيقاف جهاز يتطلب رمزًا تم إنشاؤه لعلاقة ذلك الجهاز. تمكين الوصول عن بُعد للمزود هو شرط مسبق، ولكن رمز كتالوج المزود وحده ليس بيانات اعتماد للتحكم في الجهاز. تابع مع مصادقة API الخاصة بالجهاز.
إلغاء الوصول#
قم بإلغاء رمز عندما تتوقف الأتمتة عن الحاجة إليه. يؤدي حذف أو إلغاء رمز تكامل واحد إلى إيقاف تشغيل ذلك التكامل دون استبدال الرموز غير ذات الصلة. يؤدي إيقاف تشغيل الوصول عن بُعد إلى تعطيل مسار الوصول عن بُعد لهذا المزود.
آخر تحديث سبتمبر 15, 2026