EN
DE
ES
PL
PT-BR
PT-PT
RU
TR
VI
ZH-CN
Basic API information
Introduction
Welcome to the SkinsBack API.
If you have any questions or suggestions, please contact us.
Interaction with the SkinsBack API is carried out via Endpoint https://skinsback.com/api.php, to which data must be transmitted via POST requests.
Authentication
All API requests require authentication. There are two authentication options to choose from: via HTTP headers or via signature.
Authentication via HTTP headers (easier)
It is necessary to pass two parameters in the HTTP request headers:
X-CLIENT-ID — the Client ID value from the project settings
X-CLIENT-SECRET — the Client Secret value from the project settings
Authentication via signature (more complex)
When using the legacy authentication method, you must pass two POST parameters:
shopid — the Client ID value from the project settings
sign — the signature generated according to the rules described in the Signature generation section.
Response structure
All API methods have JSON responses.
Successful API calls will have the following response:
{"status":"success", some data..}
Unsuccessful requests will contain error_code and error_message:
{"status":"error", "error_code": 5, "error_message":"some_error"}
Limiting the number of requests
Our system has a limit of 500 requests to the server per minute. If this limit is exceeded, a temporary block will occur and the API response will be as follows:
{"status":"error", "error_code": -7, "error_message":"request_limit_reached"}