Khoá của tài khoản này

Đăng nhập để lấy khoá. Khoá đại diện đúng ví đang đăng nhập: mua qua API trừ coin của tài khoản đó.

Kiểm tra key POOL

Dán key bắt đầu bằng sk-. Xem được mọi key POOL, không cần đăng nhập và không cần gắn tài khoản.

Cần có gì

1. Đăng nhập rồi bấm Tạo khoá. Khoá sk_ là chính tài khoản đó. Gửi trong header, không dán lên web công khai. Tạo khoá mới thì khoá cũ hết hiệu lực.
2. Ví coin gắn với khoá đó còn tiền. Hết coin thì nạp trên trang Nạp, hoặc nhờ shop cộng coin.
3. Mỗi lần mua một requestId riêng, dài 16–128 ký tự, chỉ chữ, số, dấu gạch, gạch dưới và dấu chấm.

Gốc API: https://sky-sky-sky.com

Mọi lệnh đều kèm:

Authorization: Bearer sk_KHOA_CUA_BAN
Accept: application/json

1. Xem hàng đang bán

GET /api/partner/products

curl -s https://sky-sky-sky.com/api/partner/products \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Mỗi sản phẩm có id, label, coins (giá 1 cái), stock hoặc unlimited: true. Nếu có variants thì phải gửi variantId lúc mua. Giá trong variants[].coins là giá của phân loại đó.

2. Xem số coin còn lại

GET /api/partner/balance

curl -s https://sky-sky-sky.com/api/partner/balance \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Trả accountId và balance. Đây là số coin trừ khi mua, không phải số tiền ngân hàng.

3. Mua hàng

POST /api/partner/orders với JSON:

curl -s -X POST https://sky-sky-sky.com/api/partner/orders \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN" \
  -H "Content-Type: application/json" \
  -d '{"productId":"ma-san-pham","variantId":"ma-phan-loai","quantity":1,"requestId":"don-doi-tac-000001","payosOrderCode":"3002035518737"}'

• productId lấy từ danh sách hàng.
• variantId bắt buộc khi sản phẩm có phân loại. Không có phân loại thì gửi chuỗi rỗng hoặc bỏ trường này.
• quantity từ 1 đến 50. Bỏ trống thì tính là 1.
• requestId do bạn đặt. Gửi lại đúng mã đó thì nhận lại đúng đơn cũ, không trừ coin lần hai.
• payosOrderCode là mã số PayOS. Shop chỉ trả tài khoản khi mã đó đã xác nhận thanh toán và số tiền đủ giá gói. Chưa xác nhận thì không trừ coin và không có content.

Lần mua mới trả HTTP 201. Gọi lại cùng requestId trả HTTP 200.

Đơn đã giao có status: "delivered" và content là nội dung hàng (tài khoản, mật khẩu, file text). coinsSpent là coin vừa trừ, balance là số còn lại. files liệt kê tệp đính kèm nếu có.

status: "processing" nghĩa là shop chưa giao xong. Giữ id và gọi mục 4 cho đến khi thành delivered.

4. Đọc lại đơn và tải tệp

GET /api/partner/orders/{id}

curl -s https://sky-sky-sky.com/api/partner/orders/buy_MA_DON \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Tệp thứ nhất: GET /api/partner/orders/{id}/file?i=0. Tệp tiếp theo tăng i lên 1, 2, …

curl -L -o hang.bin \
  "https://sky-sky-sky.com/api/partner/orders/buy_MA_DON/file?i=0" \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

5. Danh sách đơn đã mua bằng khoá này

GET /api/partner/orders

curl -s https://sky-sky-sky.com/api/partner/orders \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Mỗi dòng có productId, variantId, label, quantity, coinsSpent, status, createdAt và requestId. Nội dung hàng nằm ở mục 4, không nằm trong danh sách này.

6. Kiểm tra key POOL

Trên trang này, dán key sk- vào ô Kiểm tra key POOL. Không cần đăng nhập. Xem được mọi key POOL, không chỉ key của một tài khoản.

Với khoá mua hàng sk_: GET /api/partner/pool-keys

curl -s https://sky-sky-sky.com/api/partner/pool-keys \
  -H "Authorization: Bearer sk_KHOA_CUA_BAN"

Trả đúng các key POOL của ví gắn với khoá sk_. Mỗi key có key, pack, dollars, quotaUsed, expiresAt, status (pending, active, expired, exhausted) và detail (token vào, token ra, cache, số request, số đô đã tiêu). Gọi lại để xem số mới. Hết số đô thì request kế tiếp dừng.

Lỗi thường gặp

• 401 — thiếu khoá, khoá sai, hoặc khoá đã bị thu hồi.
• 402 — không đủ coin. Xem needed, have, short.
• 409 — hết hàng, hoặc requestId đã dùng cho một đơn khác.
• 400 — thiếu phân loại, hoặc requestId không đúng dạng.
• 404 — không có sản phẩm hoặc không có đơn đó trên ví của khoá này.

Đơn nội dung RF là hoàn tiền, không phải hàng. Đừng đưa đơn đó cho khách của bạn.