需开通API服务、获取Access Token、调用RESTful接口、按要求签名验证，并处理401/403/429等错误码。

如果您希望将任推邦平台中的业务数据接入自有系统，需通过其提供的数据API接口实现数据对接。以下是任推邦数据API接口的接入方式与技术文档指引：

一、确认API服务开通状态

任推邦的数据API接口属于企业级功能模块，需在后台完成权限申请与服务开通后方可调用。未开通状态下所有请求将返回403错误。

1、登录任推邦管理后台，进入【系统设置】→【开发者中心】。

2、检查【数据API服务】开关是否为“已启用”状态。

3、若显示“未开通”，点击【立即申请】，填写应用名称、回调域名、数据使用场景说明并提交审核。

4、审核通过后，页面将生成AppKey与AppSecret，二者为后续签名认证的必要参数。

二、获取访问令牌（Access Token）

所有数据API调用均需携带有效Access Token，该令牌采用OAuth 2.0机制颁发，有效期为2小时，需在过期前刷新。

1、向https://api.rentuibang.com/oauth/token发送POST请求。

2、请求头中设置Content-Type: application/x-www-form-urlencoded。

3、请求体包含以下字段：grant_type=client_credentials、app_key=[您的AppKey]、app_secret=[您的AppSecret]。

4、成功响应中将返回JSON格式的access_token字段，例如：{"access_token":"at_abc123xyz","expires_in":7200}。

三、调用核心数据接口

任推邦提供三类基础数据接口：客户列表、订单明细、推广效果统计。各接口均采用RESTful风格，统一使用HTTPS协议与JSON格式交互。

1、客户列表接口地址为：GET https://api.rentuibang.com/v1/customers，支持page、page_size、updated_after参数分页与增量拉取。

2、订单明细接口需携带订单时间范围，示例请求：GET https://api.rentuibang.com/v1/orders?start_time=2024-05-01T00:00:00Z&end_time=2024-05-07T23:59:59Z。

3、推广效果统计接口返回按渠道、日期聚合的数据，必须在Header中添加Authorization: Bearer [access_token]。

四、签名验证与安全要求

除Access Token外，部分敏感接口（如客户手机号字段）要求对请求参数进行HMAC-SHA256签名，防止参数篡改与重放攻击。

1、将所有请求参数（含timestamp、nonce、app_key）按字典序升序排列并拼接为key1=value1&key2=value2格式。

2、使用AppSecret作为密钥，对该字符串执行HMAC-SHA256运算，输出结果转为十六进制小写字符串。

3、将生成的签名值放入请求Header中，键名为X-Rtb-Signature。

4、同时在Header中传入当前毫秒级时间戳（X-Rtb-Timestamp）与随机字符串（X-Rtb-Nonce），服务器将校验时间偏差是否超过5分钟。

五、错误码与调试建议

任推邦API统一返回标准HTTP状态码与业务错误码，便于快速定位问题类型。调试阶段应优先关注响应头中的X-Rtb-Request-Id字段，用于日志追踪。

1、HTTP 401错误表示Access Token失效或未传入，需重新获取令牌。

2、HTTP 403错误常见于权限不足或签名验证失败，需检查AppKey/AppSecret是否正确、签名算法是否遗漏timestamp或nonce。

3、HTTP 429错误表示单位时间内请求超限，任推邦默认QPS限制为20次/秒，企业版可申请提升至100次/秒。

4、当返回JSON中出现{"code":1005,"message":"invalid signature"}时，表明签名字符串未包含全部必传参数或排序错误。