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
Auth:Bearer Token
Limite:5/minute

Richiesta parametri

Tutti i parametri possono essere passati tramite Query o Body

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

Risposta

ParametroTipoObbligoDescrizione
code
integerObbligo
1 indicates success; otherwise a token, validation or source error code
Esempio: 1
msg
stringObbligo
Localized result message
Esempio: 获取成功
time
integerObbligo
Unix timestamp in seconds
data
objectObbligo
Allowlisted fields visible to the source owner
Esempio di risposta
{
"code":1,
"msg":"Operation successful",
"time":1780000000,
"data":
{
"source_id":"12345678",
"source_url":"/api/rjy/12345678/appstore",
"app_ids":
[
1
]
}
}

Codici di errore

Codici di errore4 definito
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

Lingua di risposta

Personalizza il linguaggio di risposta API con l'intestazione X-Lang. Gli esempi di codice qui sotto utilizzano automaticamente la lingua del tuo sito corrente.

Intestazione consigliata
X-Lang: it
Lingue supportate
zh, en, zh-TW, vi, ar, es, ru

Accetta-Language è anche supportato; X-Lang prende la priorità.

Esempi di codice

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/quick-setup" \
  -H "X-Lang: it" \
  -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"
      }
    ]
  }'

Note

  • 必须使用 HTTPS 传输。接口不接受 uid、tenant_id、is_official、到期时间等管理员字段。
  • 响应不包含拥有者身份、内部草稿或敏感密钥;创建源和应用受订阅、试用及数量限制。
  • 源、应用、版本快照与幂等记录在一个事务中提交;任何一步失败都不会留下半成品。
  • 同一用户和租户复用 Idempotency-Key 却更改请求内容时,返回 HTTP 409。

Provalo in Console

Compila i parametri qui sotto e invia una richiesta al test. Le richieste vanno solo all'API di questo sito; l'URL è bloccato e non può essere modificato e il cookie di login corrente è incluso.

POSThttps://testypro.iwai.cc/api/appstore/manage/quick-setupBloccato a questo sito
stringObbligo

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

objectObbligo

Source settings object; name is required

array

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