作者： jqsz

tiktok账号绑定BC

为tiktok广告账号绑定BC，POST请求

POST /binding_bc  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,  
    "access_token": <String>,
    "bc_id": <String>,                                  
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
idString账号ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
bc_idStringbc_id
req_headerObject
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header":{
        "code": <Int>,
        "message": <String>,
        "search_id" <String>:
    }
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回提示信息
search_idString唯一标识一个请求

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效

tiktok账号解绑BC

为tiktok广告账号解绑bc，POST请求

POST /remove_bc  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,  
    "access_token": <String>,
    "bc_id": <String>,                                  
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
idString账号ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
bc_idStringbc_id
req_headerObject
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header":{
        "code": <Int>,
        "message": <String>,
        "search_id" <String>:
    }
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回提示信息
search_idString唯一标识一个请求

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效

广告账户操作状态查询

根据广告账户余额修改接口返回的id，查询操作是否成功

GET /account_operation_status  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>, 
    "access_token": <String>,                                   
    "req_header": { ​                               
        "search_id": <String>  ​                   
    },
    "operation_type":1     
}
字段类型注释
idString操作ID
req_headerObject
search_idString唯一标识一个请求
operation_typeint操作类型，1资金，2绑定/解绑

返回的结果：

{
    "resp_header": {
        "code": <Int> ,
        "message": <String> ,
        "search_id": <String>
    },
    "data": {
        "examine_status": <int> ,
        "type": <int> 
    }
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回提示信息
search_idString唯一标识一个请求
dataObject
examine_statusBool执行状态：1 待审批,2 审批通过(操作成功),3 审批未通过,4 操作失败,5 操作执行中
typeString操作类型:1 充值,2 清零,3 减款

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1020该广告账户已被设置成违规账户
1021该广告账户的开户公司已被列入黑名单

客户额度查询

客户额度查询 POST请求

POST /credit_limit  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                                       
    "access_token": <String>,                            
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
access_tokenString联系开发人员获取token，token是和公司主体绑定的
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header": {
        "code": 1,
        "message": "成功",
        "search_id": "a123456"
    },
    "data": {
        "credit_limit": 10000.00,
        "outstanding_balance": 10000.00,
        "temporary_credit_limit": 10000.00
    }
}
字段类型注释
codeString返回的编码，1：成功
messageString返回的提示信息
search_idString唯一标识一个请求
credit_limitFloat长期授信额度
outstanding_balanceFloat已使用额度
temporary_credit_limitFloat临时授信额度

剩余额度计算公式： 长期授信额度 + 临时授信额度 -已使用额度

开户审批

审批开户请求

POST /process_request  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,                    
    "access_token": <String>,          
    "status": <Int>,                    
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
idString申请单ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
statusInt1 通过，2 驳回
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header":{
        "code":,
        "message": ,
        "search_id":
    }
}
字段类型注释
codeString返回的编码，1：成功
messageString返回的提示信息
search_idString唯一标识一个请求

错误编码：

编码注释
1001系统异常
1002id 不能为空
1031数据未找到
1032开户申请状态错误
1033审批状态错误
1034操作失败

获取开户申请token

GET /apply_new_token HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{
    "access_token": <String>,
    "req_header": {
        "search_id": <String>  ​                   
    }
}
字段类型注释
access_tokenString联系开发人员获取token，token是和公司主体绑定的
req_headerObject
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header": {
        "code": 1,
        "message": "成功",
        "search_id": "234123"
    },
    "data": {
        "token": "1021248233229756"
    }
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回提示信息
search_idString唯一标识一个请求
dataJsonArray
tokenString新获取的开户申请token

错误编码：

编码注释
1001系统异常
1030Facebook API 返回错误,请稍后重试
20010无效的 access_token
20015客户状态异常

广告账户列表

GET /account_list  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{
    "access_token": <String>,
    "req_header": {
        "search_id": <String>  ​                   
    },
    "page_num":1,
    "page_size":100,
    "create_start_date":"2024-05-01",
    "create_end_date":"2024-05-31",
    "platform":1
}
字段类型注释
access_tokenString联系开发人员获取token，token是和公司主体绑定的
req_headerObject
search_idString唯一标识一个请求
page_numInt分页查询当前页数
page_sizeInt分页查询每页数据条数（不超过500）
create_start_dateString下户起始日期
create_end_dateString下户截止日期
idString账户 ID（多个用英文逗号分隔，不超过50个）
platformShort1:meta; 2:twitter; 3google; 5tiktok;12taboola

返回的结果：

{
    "resp_header": {
        "code": <Int> ,
        "message": <String> ,
        "search_id": <String>
    },
    "data": {
        "list": [
            {
                "id": <String>,
                "name": <String>,
                "created_time": <String>,
                "status": <Int>,
                "spend_cap": <Float>,
                "amount_spent": <Float>,
                "total_spend": <Float>,
                "company_name": <String>,
                "request_id": <String>,
                "violation": <Bool>,
                "violation_reason": <String>,
                "blacklist": <Int>,
                "time_zone": <String>
            }
        ],
        "total_count": 100
    }
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回提示信息
search_idString唯一标识一个请求
dataJsonArray
idString账户 ID
nameString账户名称
created_timeString下户时间
statusInt账户状态：1 正常,2 已关闭,3 封户,4 空户,7 封户-清零中
spend_capFloat花费上限
amount_spentFloat当前花费
total_spendFloat历史总花费
company_nameString开户主体（中文）
request_idString申请单编号
violationBool是否违规
violation_reasonString违规原因
blacklistInt黑名单类型：0 不在黑名单,1 今日黑名单, 2 7天惩罚期, 3 14天惩罚期, 4 永久惩罚期
time_zoneString时区

错误编码：

编码注释
1001系统异常
1015缺少时间范围相关参数或参数错误
1027分页参数错误

广告账户已绑定的pixel列表

通过账号ID，查询该账号已绑定的pixel列表，GET请求

GET /account_pixel_list  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,  
    "access_token": <String>,                                
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
idString账号ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
req_headerObject
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header": {
        "code": <Int> ,
        "message": <String> ,
        "search_id": <String>
    },
    "data": [{
        "id": <String> ,
        "name": <String> ,
    }]
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回提示信息
search_idString唯一标识一个请求
dataJsonArray
idStringpixel ID
nameStringpixel 名称

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1006Facebook API 返回错误信息
1011Facebook API 请求超时

广告账户解绑pixel

通过账号ID，pixel ID 解除绑定关系，POST请求

POST /account_remove_pixel  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,  
    "access_token": <String>,
    "pixel_id": <String>,                                  
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
idString账号ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
pixel_idStringpixel_id
req_headerObject
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header":{
        "code": <Int>,
        "message": <String>,
        "search_id" <String>:
    }
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回提示信息
search_idString唯一标识一个请求

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1011Facebook API 请求超时
1023pixel_id 不能为空

广告账户绑定pixel

为广告账号绑定pixel，POST请求

POST /account_binding_pixel  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,  
    "access_token": <String>,
    "pixel_id": <String>,                                  
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
idString账号ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
pixel_idStringpixel_id
req_headerObject
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header":{
        "code": <Int>,
        "message": <String>,
        "search_id" <String>:
    }
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回提示信息
search_idString唯一标识一个请求

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1011Facebook API 请求超时
1023pixel_id 不能为空