POST
v1.0.0stableالتهيئة السريعة للمصدر
التهيئة السريعة للمصدر؛ يمكنك إدارة المصادر المملوكة لهذا الرمز في الموقع الحالي فقط.
POST
/api/appstore/manage/quick-setupالمصادقة:Bearer Token
الحد:5/دقيقة
معلمات الطلب
يمكن تمرير جميع المعلمات عبر Query أو Body
| اسم المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
Idempotency-Key | string | مطلوب | من 16 إلى 128 حرفًا أو رقمًا أو شرطة؛ تعيد الطلبات المتطابقة النتيجة نفسها خلال 24 ساعة مثال: setup-example-00000001 |
source | object | مطلوب | كائن إعدادات المصدر؛ حقل name مطلوب مثال: {"name":"我的软件源"} |
apps | array | اختياري | التطبيقات الأولية (حتى 10)؛ يتطلب كل عنصر name و download_url مثال: [{"name":"演示应用","download_url":"https://example.com/app.ipa"}] |
معلمات الاستجابة
| اسم المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
code | integer | مطلوب | 1 للنجاح؛ وإلا فهو رمز خطأ للرمز أو المعلمات أو المصدر مثال: 1 |
msg | string | مطلوب | رسالة النتيجة باللغة المحددة مثال: 获取成功 |
time | integer | مطلوب | الطابع الزمني للخادم بالثواني |
data | object | مطلوب | حقول مسموحة وآمنة لمالك المصدر فقط |
مثال الاستجابة
{}
"code":1,
"msg":"تمت العملية بنجاح",
"time":1780000000,
"data":
{}
"source_id":"12345678",
"source_url":"/api/rjy/12345678/appstore",
"app_ids":
[]
1
رموز الخطأ
رموز الخطأ4 معرّف
10الرمز غير صالح
الرمز غير صالح أو تم تغييره؛ HTTP 401
11انتهت صلاحية الرمز
انتهت صلاحية الرمز؛ HTTP 401
40001المصدر غير موجود
المصدر غير موجود أو لا يخص هذا المستخدم أو المستأجر؛ HTTP 404
لغة الاستجابة
خصص لغة استجابة API باستخدام ترويسة X-Lang. تستخدم أمثلة الكود أدناه لغة الموقع الحالية تلقائيًا.
الترويسة الموصى بها
X-Lang: arاللغات المدعومة
zh, en, zh-TW, vi, ar, es, ruيمكن استخدام Accept-Language أيضًا؛ وتكون الأولوية لـ X-Lang. تتبع اللغات غير المدعومة إعدادات اللغة الافتراضية للموقع.
أمثلة الكود
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/quick-setup" \
-H "X-Lang: ar" \
-H "Idempotency-Key: setup-example-00000001" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"source": {
"name": "我的软件源"
},
"apps": [
{
"name": "演示应用",
"download_url": "https://example.com/app.ipa"
}
]
}'ملاحظات
- استخدم HTTPS. لا تُقبل حقول المسؤول مثل uid و tenant_id و is_official وتاريخ الانتهاء.
- لا تكشف الاستجابات عن هوية المالك أو المسودات الداخلية أو المفاتيح؛ إنشاء المصادر والتطبيقات خاضع للاشتراك والتجربة والحصص.
- يُحفظ المصدر والتطبيقات والإصدارات وسجل منع التكرار في معاملة واحدة؛ يُتراجع عنها بالكامل عند الخطأ.
- إعادة استخدام Idempotency-Key بمحتوى مختلف للمستخدم والمستأجر نفسيهما تعيد HTTP 409.
جرّب في وحدة التحكم
املأ المعلمات أدناه ثم أرسل الطلب للاختبار. تُرسَل الطلبات إلى واجهة هذا الموقع فقط؛ العنوان مقفل ولا يمكن تغييره، ويُرفَق ملف تعريف الارتباط لتسجيل دخولك الحالي.
POST
https://testypro.iwai.cc/api/appstore/manage/quick-setupمقفل على هذا الموقعstringمطلوب
من 16 إلى 128 حرفًا أو رقمًا أو شرطة؛ تعيد الطلبات المتطابقة النتيجة نفسها خلال 24 ساعة
objectمطلوب
كائن إعدادات المصدر؛ حقل name مطلوب
array
التطبيقات الأولية (حتى 10)؛ يتطلب كل عنصر name و download_url