PATCH
v1.0.0stable

Cập nhật ứng dụng trong nguồn

Cập nhật ứng dụng trong nguồn; chỉ quản lý nguồn thuộc token này trong trang hiện tại.

PATCH/api/appstore/manage/sources/:source_id/apps/:app_id
Xác thực:Bearer Token
Giới hạn:30/phút

Tham số yêu cầu

Tất cả tham số có thể truyền qua Query hoặc Body

Tham sốLoạiBắt buộcMô tả
source_id
stringBắt buộc
ID nguồn thuộc người dùng tại trang hiện tại
Ví dụ: 12345678
app_id
integerBắt buộc
ID ứng dụng trong nguồn này
Ví dụ: 1
name
stringTùy chọn
Tên ứng dụng, tối đa 100 ký tự
Ví dụ: 演示应用
download_url
stringTùy chọn
URL HTTP(S) tải ứng dụng
Ví dụ: https://example.com/app.ipa
version
stringTùy chọn
Phiên bản ứng dụng
Ví dụ: 1.0
type
stringTùy chọn
Loại ứng dụng
version_desc
stringTùy chọn
Ghi chú phát hành
icon_url
stringTùy chọn
URL HTTP(S) biểu tượng ứng dụng
tint_color
stringTùy chọn
Màu chủ đề
size
stringTùy chọn
Dung lượng tệp
is_lanzou
integerTùy chọn
Liên kết LanZou Cloud: 0/1
is_locked
integerTùy chọn
Cần mã kích hoạt để mở khóa: 0/1
ios_version_limit
stringTùy chọn
Giới hạn phiên bản iOS
weigh
integerTùy chọn
Trọng số sắp xếp
status
integerTùy chọn
Hiển thị: 0=ẩn, 1=hiện; hãy phát hành bản nháp trước khi sửa

Phản hồi

Tham sốLoạiBắt buộcMô tả
code
integerBắt buộc
1 là thành công; nếu không là mã lỗi token, tham số hoặc nguồn
Ví dụ: 1
msg
stringBắt buộc
Thông báo kết quả theo ngôn ngữ
Ví dụ: 获取成功
time
integerBắt buộc
Dấu thời gian Unix tính bằng giây
data
objectBắt buộc
Chỉ gồm các trường an toàn cho chủ sở hữu nguồn
Ví dụ phản hồi
{
"code":1,
"msg":"Thao tác thành công",
"time":1780000000,
"data":
{
"id":1,
"source_id":"12345678",
"name":"演示应用",
"version":"1.0",
"download_url":"https://example.com/app.ipa",
"status":1,
"publish_status":"published"
}
}

Mã lỗi

Mã lỗi4 được định nghĩa
10
Token không hợp lệ
Token không hợp lệ hoặc đã thay đổi; HTTP 401
11
Token đã hết hạn
Token đã hết hạn; HTTP 401
40001
Không tìm thấy nguồn
Nguồn không tồn tại hoặc không thuộc người dùng/đơn vị này; HTTP 404

Ngôn ngữ phản hồi

Tùy chỉnh ngôn ngữ phản hồi API bằng header X-Lang. Ví dụ mã bên dưới tự động sử dụng ngôn ngữ trang hiện tại của bạn.

Header đề xuất
X-Lang: vi
Ngôn ngữ được hỗ trợ
zh, en, zh-TW, vi, ar, es, ru

Bạn cũng có thể dùng Accept-Language; X-Lang được ưu tiên. Ngôn ngữ không được hỗ trợ sẽ dùng ngôn ngữ dự phòng của trang.

Ví dụ mã

curl -X PATCH "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678/apps/1" \
  -H "X-Lang: vi" \
  -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,
    "status": 1
  }'

Lưu ý

  • Sử dụng HTTPS. Không chấp nhận trường quản trị như uid, tenant_id, is_official và thời hạn.
  • Phản hồi không chứa danh tính chủ sở hữu, bản nháp nội bộ hoặc khóa; tạo nguồn/ứng dụng phụ thuộc gói, thời gian dùng thử và hạn mức.

Thử trong Console

Điền các tham số bên dưới rồi gửi yêu cầu để kiểm tra. Yêu cầu chỉ gửi đến API của trang này; địa chỉ đã bị khóa và không thể thay đổi, đồng thời kèm theo Cookie đăng nhập hiện tại của bạn.

PATCHhttps://testypro.iwai.cc/api/appstore/manage/sources/12345678/apps/1Đã khóa vào trang này
stringBắt buộc

ID nguồn thuộc người dùng tại trang hiện tại

integerBắt buộc

ID ứng dụng trong nguồn này

string

Tên ứng dụng, tối đa 100 ký tự

string

URL HTTP(S) tải ứng dụng

string

Phiên bản ứng dụng

string

Loại ứng dụng

string

Ghi chú phát hành

string

URL HTTP(S) biểu tượng ứng dụng

string

Màu chủ đề

string

Dung lượng tệp

integer

Liên kết LanZou Cloud: 0/1

integer

Cần mã kích hoạt để mở khóa: 0/1

string

Giới hạn phiên bản iOS

integer

Trọng số sắp xếp

integer

Hiển thị: 0=ẩn, 1=hiện; hãy phát hành bản nháp trước khi sửa