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
Pengesahan:Bearer Token
Had:5/minit

Parameter Permintaan

Semua parameter boleh dihantar melalui Kuiri atau Badan

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

Respons

ParameterJenisDiperlukanPenerangan
code
integerDiperlukan
1 indicates success; otherwise a token, validation or source error code
Contoh: 1
msg
stringDiperlukan
Localized result message
Contoh: 获取成功
time
integerDiperlukan
Unix timestamp in seconds
data
objectDiperlukan
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":
[
1
]
}
}

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

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

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

objectDiperlukan

Source settings object; name is required

array

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