Khởi tạo nguồn nhanh

Tạo nguồn và tối đa 10 ứng dụng ban đầu trong một giao dịch, hỗ trợ thử lại không tạo trùng.

POST/api/appstore/manage/quick-setup

Xác thực:Bearer Token

Giới hạn:5/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ại	Bắt buộc	Mô tả
`Idempotency-Key`	string	Bắt buộc	16–128 chữ, số, gạch ngang hoặc gạch dưới; cùng yêu cầu trả cùng kết quả trong 24 giờ Ví dụ: setup-example-00000001
`source`	object	Bắt buộc	Đối tượng cấu hình nguồn; bắt buộc có name Ví dụ: {"name":"我的软件源"}
`apps`	array	Tùy chọn	Ứng dụng ban đầu (tối đa 10); mỗi mục cần name và download_url Ví dụ: [{"name":"演示应用","download_url":"https://example.com/app.ipa"}]

Phản hồi

Tham số	Loại	Bắt buộc	Mô tả
`code`	integer	Bắ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`	string	Bắt buộc	Thông báo kết quả theo ngôn ngữ Ví dụ: 获取成功
`time`	integer	Bắt buộc	Dấu thời gian Unix tính bằng giây
`data`	object	Bắ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",

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

"app_ids":

[

]

}

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/quick-setup" \
  -H "X-Lang: vi" \
  -H "Idempotency-Key: setup-example-00000001" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "name": "我的软件源"
    },
    "apps": [
      {
        "name": "演示应用",
        "download_url": "https://example.com/app.ipa"
      }
    ]
  }'

Lưu ý

Chỉ được quản lý nguồn thuộc người dùng sở hữu API token tại trang hiện tại.
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.
Nguồn, ứng dụng, phiên bản và biên nhận chống trùng được ghi trong một giao dịch; lỗi sẽ hoàn tác toàn bộ.
Dùng lại Idempotency-Key với nội dung khác cho cùng người dùng và đơn vị trả HTTP 409.

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/quick-setupĐã khóa vào trang này

Authorization: Bearer Token

Idempotency-KeystringBắt buộc

16–128 chữ, số, gạch ngang hoặc gạch dưới; cùng yêu cầu trả cùng kết quả trong 24 giờ

sourceobjectBắt buộc

Đối tượng cấu hình nguồn; bắt buộc có name

appsarray

Ứng dụng ban đầu (tối đa 10); mỗi mục cần name và download_url