HTTP状态码

使用TikTok for Business接口时，HTTP 状态码能帮助您恰当地处理调用成功或失败。

若返回的HTTP状态码为200，则返回码（0 或 4xxxx/5xxxx）也将同时返回。因此，当您接收到HTTP状态码为200时，您需要检查返回码，从而确认对TikTok for Business接口的调用是成功还是失败。返回码为0（ code : 0）表示对TikTok for Business接口的调用成功，而其他返回码则代表调用失败（可查看返回码了解返回码代表的具体错误）。

针对不同HTTP状态码的推荐做法

对TikTok for Business接口的调用在大部分情况下会返回HTTP状态码200，但有时也会返回HTTP状态码4xx或 5xx。请查看下表，了解如何处理不同的HTTP状态码。

| HTTP 状态码 {20%} | 描述 {40%} | 推荐做法  {40%}|
|---|---|---|
| 2xx | 请求成功。<br><br>此类状态码中最常见的为`200`，该状态码也是所有对TikTok for Business接口的调用预期返回的状态码。 | 查看并确认返回码（ `code` 的预期值为`0`）。<br><br> 若`code` 的值不是`0`，则TikTok API for Business接口调用出错，请查看返回信息（`message`的值）确认出错原因。|
| 4xx | 请求失败。常见原因有： <ul><li>API 路径不正确。</li><li>API 方法不正确。</li></ul> | 请查看返回了解详情，确认API路径及方法是否正确。 |
| 5xx |服务器无法处理请求。| 请等待大约5分钟后重新尝试调用。<br><br>若您看到同样的返回，请通过[这里](https://ads.tiktok.com/athena/requester/boards?identify_key=b25033ef7782d41050cbac74f751d547e9d8ad35a39a541a0f0efbbd51fe722f)提交工单，获取技术支持。|

返回HTTP状态码200的示例

以下的两个API调用均返回了HTTP状态码200，您可通过不同的返回码确认调用是否成功。

调用成功 - "code" : 0

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "2022110918340701025107710223BCBDD9",
    "data": {
        "list": [],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_page": 0,
            "total_number": 0
        }
    }
}
(/code)

调用失败 - "code" : 40002

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 40002,
    "message": "Missing required field(s): account_id.",
    "request_id": "2022110918305001025108614416C7CC00"
}
(/code)