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

Parámetros de solicitud

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

ParámetroTipoRequeridoDescripción
Idempotency-Key
stringRequerido
16–128 letters, digits, hyphens or underscores; identical requests return the same result for 24 hours
Ejemplo: setup-example-00000001
source
objectRequerido
Source settings object; name is required
Ejemplo: {"name":"我的软件源"}
apps
arrayOpcional
Initial apps (max 10); each needs name and download_url
Ejemplo: [{"name":"演示应用","download_url":"https://example.com/app.ipa"}]

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":
{
"source_id":"12345678",
"source_url":"/api/rjy/12345678/appstore",
"app_ids":
[
1
]
}
}

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/quick-setup" \
  -H "X-Lang: es" \
  -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"
      }
    ]
  }'

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

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/quick-setupBloqueado a este sitio
stringRequerido

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

objectRequerido

Source settings object; name is required

array

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