Advertiser Integration
Error Codes

HTTP Status Codes

Linkbest API uses standard HTTP status codes to represent the results of API requests. The corresponding status codes are explained as follows:

CodeResponse MessageDescription
OKEverything is working as expected.
400BAD REQUESTThe request is not acceptable, usually due to missing required parameters.
401UNAUTHORIZEDNo valid ADS_KEY provided.
403FORBIDDENThe API key used does not have permission to perform the request.
404NOT FOUNDThe requested resource does not exist.
405METHOD NOT ALLOWEDThe method used in the call is not supported.
429TOO MANY REQUESTSThe API requests are too frequent. It is recommended to reduce the request rate.
SERVER ERRORThere was an issue with the Linkbest server. (This situation is rare.)

API Business Service Error Codes

Even when the HTTP status code is 200, the API request may fail due to various reasons such as parameter errors, missing data, insufficient balance, etc. Linkbest provides the following error codes to indicate the reason for the error. You can handle the errors accordingly based on the following error codes.

Although business service errors are rare, we recommend writing code that can gracefully handle all possible API exceptions.

Error CodeDescription
200Successful response
4000Validation error, please check the parameters
4001Insufficient resources
5001Network busy