/v1/offers/accounts,
/v1/offers/currency, v.v. — với các trường riêng. Bạn tích hợp với những
danh mục mình đang bán, và danh mục được thêm vào nền tảng sau này sẽ không
ảnh hưởng đến danh mục của bạn.
Đây là giao diện công khai. Các màn hình riêng của bảng điều khiển người bán —
rút tiền, tranh chấp, cài đặt tài khoản — không nằm trong đó, và khóa API
không truy cập được chúng.
Một ưu đãi là một tin đăng trên sàn. API gọi chúng là offers, và mọi phần
dưới đây cũng vậy.
URL gốc
/v1/....
Yêu cầu đầu tiên của bạn
1
Tạo khóa
Trong bảng điều khiển người bán, vào Người bán → Khóa API và tạo một
khóa. Khóa chỉ hiển thị một lần — hãy sao chép ngay, không thể đọc lại.
2
Gửi khóa
Khóa được đặt trong header
Authorization của mọi yêu cầu. Không cần đổi
lấy thứ gì khác.3
Đọc các trường của danh mục
Lệnh tạo của mỗi danh mục nhận những gì được mô tả trên trang tham chiếu
riêng của nó — ưu đãi tài khoản có giá và hình ảnh, ưu đãi tiền tệ có sản
phẩm và tồn kho. Phần khác nhau giữa các trò chơi là Đường dẫn này nhận diện trò chơi qua
attributes, và
endpoint schema trả về chúng: các trường, kiểu dữ liệu và trường nào bắt
buộc.slug. Các đường dẫn danh mục khác
chỉ định trò chơi bằng id mà GET /v1/offers/games trả về — dùng slug
ở đó sẽ nhận 400.Việc đọc danh mục là công khai — bạn có thể khám phá trước khi có khóa.Trạng thái
Ưu đãi mới làdraft: của bạn, và không ai khác thấy được. publish chuyển
nó sang active, và người mua có thể mua ngay từ lúc đó — không có bước duyệt
trước. Đăng một ưu đãi không còn gì để bán sẽ bị từ chối với 409: hãy bổ
sung tồn kho trước. Chỉnh sửa không thay đổi trạng thái của ưu đãi — ưu đãi
active vẫn đang bán, draft vẫn là bản nháp.
unpublish đưa ưu đãi active về draft. archived là điểm cuối: DELETE
gỡ ưu đãi vĩnh viễn và vẫn để bạn xem được. sold theo đơn hàng, không theo
lệnh gọi: đơn vị cuối cùng đã thuộc về một đơn đã đóng. Ưu đãi có toàn bộ tồn
kho nằm trong các đơn đang mở vẫn là active, và đơn bị hủy sẽ trả tồn kho
về.
Kiểm duyệt có thể trả một ưu đãi đang bán về trạng thái changes_requested:
ưu đãi rời khỏi sàn, và moderation_reason_code cùng moderation_note cho
biết cần sửa gì. Lệnh PATCH tiếp theo sẽ biến nó thành draft; hãy
publish khi đã sửa xong. Ưu đãi bị kiểm duyệt gỡ vì vi phạm quy định rõ
ràng sẽ bị xóa: mọi lệnh gọi đến nó đều trả 404.
Giá
Mọi mức giá trong API này là số nguyên tính bằng cent Mỹ.price: 4990 là
$49,90. Không có số lẻ, và USD là loại tiền duy nhất.
Tiếp theo
Xác thực
Khóa, danh sách địa chỉ, giới hạn tần suất và ý nghĩa của các lỗi.
Tham chiếu API
Mọi endpoint, kèm playground để gửi yêu cầu thật.