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

Granica:5/minute

Parametry żądania

Wszystkie parametry mogą być przekazywane za pośrednictwem zapytania lub ciała

Parametr	Rodzaj	Wymagane	Opis
`Idempotency-Key`	string	Wymagane	16–128 letters, digits, hyphens or underscores; identical requests return the same result for 24 hours Przykład: setup-example-00000001
`source`	object	Wymagane	Source settings object; name is required Przykład: {"name":"我的软件源"}
`apps`	array	Opcjonalnie	Initial apps (max 10); each needs name and download_url Przykład: [{"name":"演示应用","download_url":"https://example.com/app.ipa"}]

Odpowiedź

Parametr	Rodzaj	Wymagane	Opis
`code`	integer	Wymagane	1 indicates success; otherwise a token, validation or source error code Przykład: 1
`msg`	string	Wymagane	Localized result message Przykład: 获取成功
`time`	integer	Wymagane	Unix timestamp in seconds
`data`	object	Wymagane	Allowlisted fields visible to the source owner

Przykład odpowiedzi

{

"code":1,

"msg":"Operation successful",

"time":1780000000,

"data":

{

"source_id":"12345678",

"source_url":"/api/rjy/12345678/appstore",

"app_ids":

[

]

}

Kod błędu

Kod błędu4 zdefiniowane

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

Język odpowiedzi

Dostosuj język odpowiedzi API do nagłówka X- Lang. Poniższe przykłady kodów automatycznie korzystają z aktualnego języka strony.

Zalecany nagłówek

X-Lang: pl

Obsługiwane języki

zh, en, zh-TW, vi, ar, es, ru

Obsługiwane jest również Accept- Language; X- Lang ma pierwszeństwo. Nieobsługiwane języki podążają za zapasami języka strony.

Przykłady kodów

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

Uwagi

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

Spróbuj w konsoli

Wypełnij poniższe parametry i wyślij wniosek o przetestowanie. Żądania są kierowane tylko do API tej witryny; adres URL jest zablokowany i nie może być zmieniony, a obecne pliki cookie logowania są włączone.

POSThttps://testypro.iwai.cc/api/appstore/manage/quick-setupZamknięte na tej stronie

Authorization: Bearer Token

Idempotency-KeystringWymagane

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

sourceobjectWymagane

Source settings object; name is required

appsarray

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