POST
v1.0.0stable

Add source app

Add source app. Manage only sources owned by this token on the current tenant.

POST/api/appstore/manage/sources/:source_id/apps
Аутентификация:Bearer Token
Лимит:30/минут

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

Все параметры можно передавать через Query или Body

ПараметрТипОбязательныйОписание
source_id
stringОбязательный
Source ID owned by this user on the current site
Пример: 12345678
name
stringОбязательный
App name, up to 100 characters
Пример: 演示应用
download_url
stringОбязательный
HTTP(S) URL for downloading the app
Пример: https://example.com/app.ipa
version
stringОпционально
App version
Пример: 1.0
type
stringОпционально
App type
version_desc
stringОпционально
Release notes
icon_url
stringОпционально
HTTP(S) URL of the app icon
tint_color
stringОпционально
Theme color
size
stringОпционально
File size
is_lanzou
integerОпционально
LanZou Cloud link: 0/1
is_locked
integerОпционально
Requires a license key to unlock: 0/1
ios_version_limit
stringОпционально
iOS version restriction
weigh
integerОпционально
Sort weight

Ответ

ПараметрТипОбязательныйОписание
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":
{
"id":1,
"source_id":"12345678",
"name":"演示应用",
"version":"1.0",
"download_url":"https://example.com/app.ipa",
"status":1,
"publish_status":"published"
}
}

Коды ошибок

Коды ошибок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/sources/12345678/apps" \
  -H "X-Lang: ru" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "演示应用",
    "download_url": "https://example.com/app.ipa",
    "version": "1.0",
    "type": "example_type",
    "version_desc": "example_version_desc",
    "icon_url": "example_icon_url",
    "tint_color": "example_tint_color",
    "size": "example_size",
    "is_lanzou": 1,
    "is_locked": 1,
    "ios_version_limit": "example_ios_version_limit",
    "weigh": 1
  }'

Примечания

  • 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.

Попробуйте в Консоли

Заполните параметры ниже и отправьте запрос для тестирования. Запросы отправляются только на API этого сайта; URL зафиксирован и не может быть изменен, а текущий файл cookie для входа включен.

POSThttps://testypro.iwai.cc/api/appstore/manage/sources/12345678/appsЗаблокировано для этого сайта
stringОбязательный

Source ID owned by this user on the current site

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

App name, up to 100 characters

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

HTTP(S) URL for downloading the app

string

App version

string

App type

string

Release notes

string

HTTP(S) URL of the app icon

string

Theme color

string

File size

integer

LanZou Cloud link: 0/1

integer

Requires a license key to unlock: 0/1

string

iOS version restriction

integer

Sort weight