流量接入

适用范围
本接口适用于如下产品类型:通用流量分发、定向流量管理
服务器地址
http://apidata.huaxincloud.com:8081/
接入列表
  • 查询余额接口
  • 充值回调
  • 流量充值接口
  • 流量充值状态查询接口
  • 流量包查询接口
请求地址
/custom/{accountSid}/flowPackage/getBalance
请求参数
响应包体
属性 类型 约束 举例 说明
balance String 必须 29.5 余额(单位:元)
transactId String 必须 nIqa3aSqBxcb6ZxmflF20160327 发送唯一编码
errorCode String 必须 0 发送状态0:正常
msg String 必须 正常 消息
JSON响应示例
{
"transactId":"nIqa3aSqBxcb6ZxmflF20160327",
"errorCode":"0",
"msg":"正常",
"balance":"29.5"
}
请求地址
POST / callbackURL (流量充值时的callbackurl参数); 本请求是由我方发起,请求您的服务器;此地址在“流量充值”请求中上传
请求参数
属性 类型 约束 举例 说明
transactId String 必须 SLIJFLgYbtmI6JbUUGO20150911 交易唯一编码
status String 必须 3:成功,4:失败 短信发送结果
phone String 必须 13333333333 号码
reqId String 可选 abcd1234 如果用户在请求时有reqId,会在回调时返回
errorCode String 必须 0 0:正常;其他详见错误码
msg String 必须 正常 状态码描述
JSON请求示例
{
"transactId":"SLIJFLgYbtmI6JbUUGO20150911",
"status":"3",
"phone":"13333333333",
"reqId":"abcd1234",
"errorCode":"0",
"msg":"正常"
}
响应包体
属性 类型 约束 举例 说明
result String 必须 SUCC SUCC成功,其他失败
JSON响应示例
{
"result":"SUCC"
}
请求地址
/custom/{accountSid}/flowPackage/flowRecharge
请求参数
属性 类型 约束 举例 说明
productId String 必须 B2016000009 已订购的产品ID
phone String 必须 13333333333 手机号码
standardfeeid String 必须 100001 流量包档位编码
reqId String 可选 abcd1234 用户方id
callbackUrl String 可选 http://zbc.com 回调地址
JSON请求示例
{
"phone":"18801181699",
"standardfeeid":"100006",
"productId":" B2016000029",
"callbackUrl":"http://sandboxapi.huaxincloud.com:8081/FlowNotify"
}
响应包体
属性 类型 约束 举例 说明
transactId String 必须 nIqa3aSqBxcb6ZxmflF20160327 交易唯一编码
errorCode String 必须 0 发送状态0:正常
msg String 必须 正常 消息
reqId String 可选 abcd1234 请求参数原样返
JSON响应示例
{
"transactId":"nIqa3aSqBxcb6ZxmflF20160327",
"errorCode":"0",
"msg":"正常"
}
请求地址
/custom/{accountSid}/flowPackage/flowRechargeStatus
请求参数
属性 类型 约束 举例 说明
transactId String 必须 SLIJFLgYbtmI6JbUUGO20150911 交易唯一编码
reqId String 必须 abcd1234 在有平台交易码transactId时,会忽略用户提交的reqId码
productId String 必须 B2016000009 已订购的产品ID
JSON请求示例
{
"transactId":"SLIJFLgYbtmI6JbUUGO20150911",
"productId":"B2016000029"
}
响应包体
属性 类型 约束 举例 说明
transactId String 必须 nIqa3aSqBxcb6ZxmflF20160327 交易唯一编码
errorCode String 必须 0 发送状态0:正常
msg String 必须 正常 消息
status String 可选 3 充值结果1,充值中3,成功4,失败
JSON响应示例
{
"transactId":"rXKHmdert4vNPz71IQG20160504",
"errorCode":"0",
"msg":"正常",
"status":3
}
请求地址
/custom/{accountSid}/flowPackage/getPackage
请求参数
属性 类型 约束 举例 说明
productId String 必须 B2016000009 已订购的产品ID
phone String 必须 13333333333 手机号码
JSON请求示例
{
"productId":"B2016000029",
"phone":"13333333333"
}
响应包体
结果在通用响应包的model中
属性 类型 约束 举例 说明
price int 必须 3000 价格,单位为厘
standarfeeid String 必须 100001 流量包的编码
packet String 必须 1024 流量包的大小,对应于sn
{"errorCode":"0",
"msg":"正常",
"transactId":"efji190429JFEIALW20160912",
"model":[
{"standardfeeid":"100001","packet":"30","price",3000},
{"standardfeeid":"100002","packet":"70","price",5000}
]}

恭喜您注册成功