POST

v1.0.0stable

Add source app

Add source app. Manage only sources owned by this token on the current tenant.

POST/api/appstore/manage/sources/:source_id/apps

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	Required	App name, up to 100 characters Example: 演示应用
`download_url`	string	Required	HTTP(S) URL for downloading the app Example: https://example.com/app.ipa
`version`	string	Optional	App version Example: 1.0
`type`	string	Optional	App type
`version_desc`	string	Optional	Release notes
`icon_url`	string	Optional	HTTP(S) URL of the app icon
`tint_color`	string	Optional	Theme color
`size`	string	Optional	File size
`is_lanzou`	integer	Optional	LanZou Cloud link: 0/1
`is_locked`	integer	Optional	Requires a license key to unlock: 0/1
`ios_version_limit`	string	Optional	iOS version restriction
`weigh`	integer	Optional	Sort weight

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":

{

"id":1,

"source_id":"12345678",

"name":"演示应用",

"version":"1.0",

"download_url":"https://example.com/app.ipa",

"status":1,

"publish_status":"published"

}

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 POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678/apps" \
  -H "X-Lang: en" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "演示应用",
    "download_url": "https://example.com/app.ipa",
    "version": "1.0",
    "type": "example_type",
    "version_desc": "example_version_desc",
    "icon_url": "example_icon_url",
    "tint_color": "example_tint_color",
    "size": "example_size",
    "is_lanzou": 1,
    "is_locked": 1,
    "ios_version_limit": "example_ios_version_limit",
    "weigh": 1
  }'

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.

POSThttps://testypro.iwai.cc/api/appstore/manage/sources/12345678/appsLocked to this site

Authorization: Bearer Token

source_idstringRequired

Source ID owned by this user on the current site

namestringRequired

App name, up to 100 characters

download_urlstringRequired

HTTP(S) URL for downloading the app

versionstring

App version

typestring

App type

version_descstring

Release notes

icon_urlstring

HTTP(S) URL of the app icon

tint_colorstring

Theme color

sizestring

File size

is_lanzouinteger

LanZou Cloud link: 0/1

is_lockedinteger

Requires a license key to unlock: 0/1

ios_version_limitstring

iOS version restriction

weighinteger

Sort weight