Thông tin API cơ bản
Giới thiệu
Chào mừng đến với API SkinsBack.
Nếu bạn có bất kỳ câu hỏi hoặc đề xuất nào, vui lòng liên hệ với chúng tôi.
Tương tác với API SkinsBack được thực hiện thông qua Endpoint https://skinsback.com/api.php, dữ liệu phải được truyền qua các yêu cầu POST.
Xác thực
Tất cả các yêu cầu API đều yêu cầu xác thực. Có hai tùy chọn xác thực để lựa chọn: thông qua tiêu đề HTTP hoặc thông qua chữ ký.
Xác thực thông qua tiêu đề HTTP (dễ hơn)
Cần phải truyền hai tham số trong tiêu đề yêu cầu HTTP:
X-CLIENT-ID — giá trị Client ID từ cài đặt dự án
X-CLIENT-SECRET — giá trị Client Secret từ cài đặt dự án
Xác thực thông qua chữ ký (phức tạp hơn)
Khi sử dụng phương thức xác thực cũ, bạn phải truyền hai tham số POST:
shopid — giá trị ID máy khách từ cài đặt dự án
sign — chữ ký được tạo theo các quy tắc được mô tả trong phần Tạo chữ ký.
Cấu trúc phản hồi
Tất cả các phương thức API đều có phản hồi JSON.
Các cuộc gọi API thành công sẽ có phản hồi sau:
{"status":"success", some data..}
Các yêu cầu không thành công sẽ chứa error_code và error_message:
{"status":"error", "error_code": 5, "error_message":"some_error"}
Giới hạn số lượng yêu cầu
Hệ thống của chúng tôi có giới hạn 500 yêu cầu đến máy chủ mỗi phút. Nếu vượt quá giới hạn này, một khối tạm thời sẽ xảy ra và phản hồi API sẽ như sau:
{"status":"error", "error_code": -7, "error_message":"request_limit_reached"}