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
Otentikasi:Bearer Token
Batas:5/menit

Parameter Permintaan

Semua parameter dapat dikirim melalui Query atau Body

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

Respon

ParameterTipeWajibDeskripsi
code
integerWajib
1 indicates success; otherwise a token, validation or source error code
Contoh: 1
msg
stringWajib
Localized result message
Contoh: 获取成功
time
integerWajib
Unix timestamp in seconds
data
objectWajib
Allowlisted fields visible to the source owner
Contoh Respon
{
"code":1,
"msg":"Operation successful",
"time":1780000000,
"data":
{
"source_id":"12345678",
"source_url":"/api/rjy/12345678/appstore",
"app_ids":
[
1
]
}
}

Kode Kesalahan

Kode Kesalahan4 didefinisikan
10
Token tidak valid
Token is invalid or rotated; HTTP 401
11
Token kedaluwarsa
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 Kode

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"
      }
    ]
  }'

Catatan

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

Coba di Konsol

Isi parameter di bawah ini dan kirim permintaan untuk menguji. Permintaan hanya dikirim ke API situs ini; URL terkunci dan tidak dapat diubah, dan cookie login Anda saat ini disertakan.

POSThttps://testypro.iwai.cc/api/appstore/manage/quick-setupTerkunci ke situs ini
stringWajib

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

objectWajib

Source settings object; name is required

array

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