财务相关API

功能描述

用户可通过此 API，查询账户中的 T币余额相关信息，包括可用 T 币余额、待支付 T 币、待激活 T 币以及后付费额度上限等信息。

请求URL

https://api.textin.com/user/finance/balance

HTTP请求方法

HTTP GET

请求头说明（Request Header）

请在HTTP请求中添加以下自定义Header。

header 名	值
x-ti-app-id	请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-app-id
x-ti-secret-code	请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-secret-code

响应体说明（Response Data）

Content-Type：application/json

JSON结构说明如下：

字段名	类型	描述
code	integer	错误码，详见“错误码说明”
message	string	状态说明
data	object	结果信息
+ balance	float	账户总余额
+ available_balance	float	可用 T 币余额
+ pay_type	integer	付费类型，1：预付费，2：后付费
+ postpaid_amount	float	后付费额度上限
+ unavailable_balance	float	待激活 T 币
+ unpaid	float	待支付 T 币

JSON结构示例

{"code":200,"msg":"success","data":{"balance":83.712,"available_balance":83.712,"pay_type":1,"postpaid_amount":0,"unavailable_balance":0,"unpaid":0}}

错误码说明

错误码	描述
40101	x-ti-app-id 或 x-ti-secret-code 为空
40102	x-ti-app-id 或 x-ti-secret-code 无效，验证失败
40004	参数错误，请查看技术文档，检查传参
500	服务器内部错误