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
Autenticación:Bearer Token
Límite:30/minuto

Parámetros de solicitud

Todos los parámetros se pueden pasar vía Consulta o Cuerpo

ParámetroTipoRequeridoDescripción
source_id
stringRequerido
Source ID owned by this user on the current site
Ejemplo: 12345678
name
stringRequerido
App name, up to 100 characters
Ejemplo: 演示应用
download_url
stringRequerido
HTTP(S) URL for downloading the app
Ejemplo: https://example.com/app.ipa
version
stringOpcional
App version
Ejemplo: 1.0
type
stringOpcional
App type
version_desc
stringOpcional
Release notes
icon_url
stringOpcional
HTTP(S) URL of the app icon
tint_color
stringOpcional
Theme color
size
stringOpcional
File size
is_lanzou
integerOpcional
LanZou Cloud link: 0/1
is_locked
integerOpcional
Requires a license key to unlock: 0/1
ios_version_limit
stringOpcional
iOS version restriction
weigh
integerOpcional
Sort weight

Respuesta

ParámetroTipoRequeridoDescripción
code
integerRequerido
1 indicates success; otherwise a token, validation or source error code
Ejemplo: 1
msg
stringRequerido
Localized result message
Ejemplo: 获取成功
time
integerRequerido
Unix timestamp in seconds
data
objectRequerido
Allowlisted fields visible to the source owner
Ejemplo de respuesta
{
"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"
}
}

Códigos de error

Códigos de error4 definido
10
Token inválido
Token is invalid or rotated; HTTP 401
11
Token expirado
Token has expired; HTTP 401
40001
Source not found
Source is missing or not owned by this user/tenant; HTTP 404

Idioma de respuesta

Personaliza el idioma de respuesta de la API con la cabecera X-Lang. Los ejemplos de código usan automáticamente el idioma actual del sitio.

Cabecera recomendada
X-Lang: es
Idiomas compatibles
zh, en, zh-TW, vi, ar, es, ru

También se admite Accept-Language; X-Lang tiene prioridad. Los idiomas no admitidos siguen la configuración de idioma predeterminada del sitio.

Ejemplos de código

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678/apps" \
  -H "X-Lang: es" \
  -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
  }'

Notas

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

Pruébalo en la Consola

Complete los parámetros a continuación y envíe una solicitud para probar. Las solicitudes solo van a la API de este sitio; la URL está bloqueada y no se puede cambiar, y se incluye su cookie de inicio de sesión actual.

POSThttps://testypro.iwai.cc/api/appstore/manage/sources/12345678/appsBloqueado a este sitio
stringRequerido

Source ID owned by this user on the current site

stringRequerido

App name, up to 100 characters

stringRequerido

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