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/минут

Параметры запроса

Все параметры можно передавать через 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":

[

]

}

Коды ошибок

Коды ошибок4 определено

10

Недействительный токен

Token is invalid or rotated; HTTP 401

11

Токен истек

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: ru

Поддерживаемые языки

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: ru" \
  -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 зафиксирован и не может быть изменен, а текущий файл cookie для входа включен.

POSThttps://testypro.iwai.cc/api/appstore/manage/quick-setupЗаблокировано для этого сайта

Authorization: Bearer Token

Idempotency-KeystringОбязательный

16–128 letters, digits, hyphens or underscores; identical requests return the same result for 24 hours

sourceobjectОбязательный

Source settings object; name is required

appsarray

Initial apps (max 10); each needs name and download_url