PATCH

v1.0.0stable

Update source settings

Update source settings. Manage only sources owned by this token on the current tenant.

PATCH/api/appstore/manage/sources/:source_id

Auth:Bearer Token

Limit:30/minute

Request Parameters

All parameters can be passed via Query or Body

Parameter	Type	Required	Description
`source_id`	string	Required	Source ID owned by this user on the current site Example: 12345678
`name`	string	Optional	Source name, up to 100 characters Example: 我的软件源
`message`	string	Optional	Source announcement Example: 欢迎使用
`identifier`	string	Optional	Source identifier, up to 100 characters
`source_icon`	string	Optional	HTTP(S) URL of the source icon
`pay_url`	string	Optional	HTTP(S) URL of the payment page
`encrypt_enabled`	integer	Optional	Response encryption: 0=off, 1=on (default on when created) Example: 1
`open_black`	integer	Optional	Auto-block devices used to add apps: 0/1 Example: 0
`open_black2`	integer	Optional	Auto-block cracking attempts: 0/1 Example: 0
`health_alert`	object	Optional	Complete link-health alert configuration as a JSON object

Response

Parameter	Type	Required	Description
`code`	integer	Required	1 indicates success; otherwise a token, validation or source error code Example: 1
`msg`	string	Required	Localized result message Example: 获取成功
`time`	integer	Required	Unix timestamp in seconds
`data`	object	Required	Allowlisted fields visible to the source owner

Response Example

{

"code":1,

"msg":"Operation successful",

"time":1780000000,

"data":

{

"source_id":"12345678",

"name":"我的软件源",

"source_url":"/api/rjy/12345678/appstore",

"message":"欢迎使用",

"encrypt_enabled":1,

"app_count":0

}

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 PATCH "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678" \
  -H "X-Lang: en" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "我的软件源",
    "message": "欢迎使用",
    "identifier": "example_identifier",
    "source_icon": "example_source_icon",
    "pay_url": "example_pay_url",
    "encrypt_enabled": 1,
    "open_black": 0,
    "open_black2": 0,
    "health_alert": "example_health_alert"
  }'

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.
Only supplied fields are updated; health_alert replaces the whole object.

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.

PATCHhttps://testypro.iwai.cc/api/appstore/manage/sources/12345678Locked to this site

Authorization: Bearer Token

source_idstringRequired

Source ID owned by this user on the current site

namestring

Source name, up to 100 characters

messagestring

Source announcement

identifierstring

Source identifier, up to 100 characters

source_iconstring

HTTP(S) URL of the source icon

pay_urlstring

HTTP(S) URL of the payment page

encrypt_enabledinteger

Response encryption: 0=off, 1=on (default on when created)

open_blackinteger

Auto-block devices used to add apps: 0/1

open_black2integer

Auto-block cracking attempts: 0/1

health_alertobject

Complete link-health alert configuration as a JSON object