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/minute
Параметри запиту
Всі параметри можуть бути передані через Query або тіло
| Параметр | Тип | Потрібні | Опис |
|---|---|---|---|
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 визначено
10Invalid token
Token is invalid or rotated; HTTP 401
11Token expired
Token has expired; HTTP 401
40001Source not found
Source is missing or not owned by this user/tenant; HTTP 404
Мова відповіді
Налаштуйте мову відповіді API з заголовком X-Lang. Приклади коду нижче автоматично використовуйте мову поточного сайту.
Рекомендований заголовок
X-Lang: ukПідтримувані мови
zh, en, zh-TW, vi, ar, es, ruЗа підтримки 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: uk" \
-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。
Спробуйте в Консоль
Заповнювати параметри нижче і відправити запит на тест. Запити тільки перейти до цього API сайту; URL-адреса заблокована і не може бути змінена, і ваш поточний логін cookie включено.
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