Quick source setup

Create a source and up to 10 initial apps in one transaction, with idempotent retries.

POST/api/appstore/manage/quick-setup

Pengesahan:Bearer Token

Had:5/minit

Parameter Permintaan

Semua parameter boleh dihantar melalui Kuiri atau Badan

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

Respons

Parameter	Jenis	Diperlukan	Penerangan
`code`	integer	Diperlukan	1 indicates success; otherwise a token, validation or source error code Contoh: 1
`msg`	string	Diperlukan	Localized result message Contoh: 获取成功
`time`	integer	Diperlukan	Unix timestamp in seconds
`data`	object	Diperlukan	Allowlisted fields visible to the source owner

Contoh Respons

{

"code":1,

"msg":"Operation successful",

"time":1780000000,

"data":

{

"source_id":"12345678",

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

"app_ids":

[

]

}

Kod Ralat

Kod Ralat4 ditakrifkan

10

Token tidak sah

Token is invalid or rotated; HTTP 401

11

Token tamat tempoh

Token has expired; HTTP 401

40001

Source not found

Source is missing or not owned by this user/tenant; HTTP 404

Response Language

Customize the API response language with the X-Lang header. The code examples below automatically use your current site language.

Recommended Header

X-Lang: en

Supported Languages

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

Accept-Language is also supported; X-Lang takes priority. Unsupported languages follow the site language fallback.

Contoh Kod

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

Nota

Only sources owned by the API token user on the current site can be managed.
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.

Cuba di Konsol

Isikan parameter di bawah dan hantar permintaan untuk menguji. Permintaan hanya dihantar ke API laman ini; URL dikunci dan tidak boleh diubah, dan kuki log masuk semasa anda disertakan.

POSThttps://testypro.iwai.cc/api/appstore/manage/quick-setupDikunci ke laman ini

Authorization: Bearer Token

Idempotency-KeystringDiperlukan

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

sourceobjectDiperlukan

Source settings object; name is required

appsarray

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