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
Yetkilendirme:Bearer Token
Limit:5/dakika

İstek Parametreleri

Tüm parametreler Sorgu veya Gövde üzerinden iletilebilir

ParametreTürGerekliAçıklama
Idempotency-Key
stringGerekli
16–128 letters, digits, hyphens or underscores; identical requests return the same result for 24 hours
Örnek: setup-example-00000001
source
objectGerekli
Source settings object; name is required
Örnek: {"name":"我的软件源"}
apps
arrayİsteğe bağlı
Initial apps (max 10); each needs name and download_url
Örnek: [{"name":"演示应用","download_url":"https://example.com/app.ipa"}]

Yanıt

ParametreTürGerekliAçıklama
code
integerGerekli
1 indicates success; otherwise a token, validation or source error code
Örnek: 1
msg
stringGerekli
Localized result message
Örnek: 获取成功
time
integerGerekli
Unix timestamp in seconds
data
objectGerekli
Allowlisted fields visible to the source owner
Yanıt Örneği
{
"code":1,
"msg":"Operation successful",
"time":1780000000,
"data":
{
"source_id":"12345678",
"source_url":"/api/rjy/12345678/appstore",
"app_ids":
[
1
]
}
}

Hata Kodları

Hata Kodları4 tanımlandı
10
Geçersiz token
Token is invalid or rotated; HTTP 401
11
Token süresi doldu
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.

Kod Örnekleri

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

Notlar

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

Konsolda deneyin

Aşağıdaki parametreleri doldurun ve testi yapmak için bir istek gönderin. İstekler yalnızca bu sitenin API'sine gider; URL kilitli ve değiştirilemez, mevcut giriş çereziniz dahil edilir.

POSThttps://testypro.iwai.cc/api/appstore/manage/quick-setupBu siteye kilitli
stringGerekli

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

objectGerekli

Source settings object; name is required

array

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