PUT
v1.0.0stable

Reorder source apps

Reorder source apps. Manage only sources owned by this token on the current tenant.

PUT/api/appstore/manage/sources/:source_id/apps/order
Auth:Bearer Token
Limit:30/minute

Request Parameters

All parameters can be passed via Query or Body

ParameterTypeRequiredDescription
source_id
stringRequired
Source ID owned by this user on the current site
Example: 12345678
app_ids
arrayRequired
Ordered array of app IDs (1–200 items)
Example: [1,2]

Response

ParameterTypeRequiredDescription
code
integerRequired
1 indicates success; otherwise a token, validation or source error code
Example: 1
msg
stringRequired
Localized result message
Example: 获取成功
time
integerRequired
Unix timestamp in seconds
data
objectRequired
Allowlisted fields visible to the source owner
Response Example
{
"code":1,
"msg":"Operation successful",
"time":1780000000,
"data":
{
"app_ids":
[
1,
2
]
}
}

Error Codes

Error Codes4 defined
10
Invalid token
Token is invalid or rotated; HTTP 401
11
Token expired
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.

Code Examples

curl -X PUT "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678/apps/order" \
  -H "X-Lang: en" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "app_ids": [
      1,
      2
    ]
  }'

Notes

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

Try it in Console

Fill in the parameters below and send a request to test. Requests only go to this site's API; the URL is locked and cannot be changed, and your current login cookie is included.

PUThttps://testypro.iwai.cc/api/appstore/manage/sources/12345678/apps/orderLocked to this site
stringRequired

Source ID owned by this user on the current site

arrayRequired

Ordered array of app IDs (1–200 items)