POST
v1.0.0stable

Tạo nguồn ứng dụng

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

POST/api/appstore/manage/sources
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ả
name
stringBắt buộc
Tên nguồn, tối đa 100 ký tự
Ví dụ: 我的软件源
message
stringTùy chọn
Thông báo của nguồn
Ví dụ: 欢迎使用
identifier
stringTùy chọn
Mã định danh nguồn, tối đa 100 ký tự
source_icon
stringTùy chọn
URL HTTP(S) biểu tượng nguồn
pay_url
stringTùy chọn
URL HTTP(S) trang thanh toán
encrypt_enabled
integerTùy chọn
Mã hóa phản hồi: 0=tắt, 1=bật (mặc định bật)
Ví dụ: 1
open_black
integerTùy chọn
Tự động chặn thiết bị thêm ứng dụng: 0/1
Ví dụ: 0
open_black2
integerTùy chọn
Tự động chặn hành vi bẻ khóa: 0/1
Ví dụ: 0
health_alert
objectTùy chọn
Đối tượng JSON cấu hình cảnh báo liên kết đầy đủ

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":
{
"source_id":"12345678",
"name":"我的软件源",
"source_url":"/api/rjy/12345678/appstore",
"message":"欢迎使用",
"encrypt_enabled":1,
"app_count":0
}
}

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

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.

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

Tên nguồn, tối đa 100 ký tự

string

Thông báo của nguồn

string

Mã định danh nguồn, tối đa 100 ký tự

string

URL HTTP(S) biểu tượng nguồn

string

URL HTTP(S) trang thanh toán

integer

Mã hóa phản hồi: 0=tắt, 1=bật (mặc định bật)

integer

Tự động chặn thiết bị thêm ứng dụng: 0/1

integer

Tự động chặn hành vi bẻ khóa: 0/1

object

Đối tượng JSON cấu hình cảnh báo liên kết đầy đủ