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
Authentifizierung:Bearer Token
Begrenzung:5/Minute

Anforderungsparameter

Alle Parameter können über Query oder Body übergeben werden

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

Antwort

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

Fehlercodes

Fehlercodes4 definiert
10
Ungültiges Token
Token is invalid or rotated; HTTP 401
11
Token abgelaufen
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.

Codebeispiele

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

Hinweise

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

Versuchen Sie es in der Konsole

Füllen Sie die untenstehenden Parameter aus und senden Sie eine Anfrage zum Testen. Anfragen gehen nur an die API dieser Seite; die URL ist gesperrt und kann nicht geändert werden, und Ihr aktuelles Login-Cookie ist enthalten.

POSThttps://testypro.iwai.cc/api/appstore/manage/quick-setupGesperrt für diese Seite
stringErforderlich

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

objectErforderlich

Source settings object; name is required

array

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