POST
v1.0.0stable

Quick 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 визначено
10
Invalid token
Token is invalid or rotated; HTTP 401
11
Token expired
Token has expired; HTTP 401
40001
Source 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 включено.

POSThttps://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