POST
v1.0.0stableQuick source setup
Quick source setup. Manage only sources owned by this token on the current tenant.
POST
/api/appstore/manage/quick-setupการยืนยันตัวตน:Bearer Token
ขีดจำกัด:5/นาที
พารามิเตอร์คำขอ
พารามิเตอร์ทั้งหมดสามารถส่งผ่าน Query หรือ Body
| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
Idempotency-Key | string | จำเป็น | 16–128 letters, digits, hyphens or underscores; identical requests return the same result for 24 hours ตัวอย่าง: setup-example-00000001 |
source | object | จำเป็น | Source settings object; name is required ตัวอย่าง: {"name":"我的软件源"} |
apps | array | ตัวเลือก | Initial apps (max 10); each needs name and download_url ตัวอย่าง: [{"name":"演示应用","download_url":"https://example.com/app.ipa"}] |
การตอบสนอง
| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
code | integer | จำเป็น | 1 indicates success; otherwise a token, validation or source error code ตัวอย่าง: 1 |
msg | string | จำเป็น | Localized result message ตัวอย่าง: 获取成功 |
time | integer | จำเป็น | Unix timestamp in seconds |
data | object | จำเป็น | Allowlisted fields visible to the source owner |
ตัวอย่างการตอบสนอง
{}
"code":1,
"msg":"Operation successful",
"time":1780000000,
"data":
{}
"source_id":"12345678",
"source_url":"/api/rjy/12345678/appstore",
"app_ids":
[]
1
รหัสข้อผิดพลาด
รหัสข้อผิดพลาด4 กำหนดไว้
10โทเค็นไม่ถูกต้อง
Token is invalid or rotated; HTTP 401
11โทเค็นหมดอายุ
Token has expired; HTTP 401
40001Source not found
Source is missing or not owned by this user/tenant; HTTP 404
Response Language
Customize the API response language with the X-Lang header. The code examples below automatically use your current site language.
Recommended Header
X-Lang: enSupported Languages
zh, en, zh-TW, vi, ar, es, ruAccept-Language is also supported; X-Lang takes priority. Unsupported languages follow the site language fallback.
ตัวอย่างโค้ด
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/quick-setup" \
-H "X-Lang: en" \
-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"
}
]
}'หมายเหตุ
- Use HTTPS. Administrator-only fields such as uid, tenant_id, is_official and expiry time are rejected.
- Responses omit owner identities, draft internals and secrets; creating sources/apps is subject to subscription, trial and quota limits.
- Source, apps, versions and the idempotency receipt commit atomically; failures leave nothing behind.
- Reusing an Idempotency-Key with different content within the same user and tenant returns HTTP 409.
ลองใช้ในคอนโซล
กรอกพารามิเตอร์ด้านล่างและส่งคำขอเพื่อทดสอบ คำขอจะส่งไปยัง API ของเว็บไซต์นี้เท่านั้น URL ถูกล็อกและไม่สามารถเปลี่ยนแปลงได้ และคุกกี้การล็อกอินปัจจุบันของคุณถูกแนบมา
POST
https://testypro.iwai.cc/api/appstore/manage/quick-setupถูกล็อกกับเว็บไซต์นี้stringจำเป็น
16–128 letters, digits, hyphens or underscores; identical requests return the same result for 24 hours
objectจำเป็น
Source settings object; name is required
array
Initial apps (max 10); each needs name and download_url