手机话费充值接口开发指南(含API文档,充值移动、联通、电信话费)
平台上个星期上线了下载APP送随机话费的活动,下载后完成注册即可抽取1~10元话费红包。经过筛选,最终选择了互亿无线,第一有详细的计费明细,第二失败了确实有退款,第三有非常完整的接口文档和技术服务客服,分享一下他们家的文档,后续小伙伴搞话费充值功能时也可以参考下。
话费接口服务商:互亿无线(www.ihuyi.com)
话费接口地址:http://f.ihuyi.com/phone
1.单号码充值话费
请求(POST 或者GET)
类型 |
参数名称 |
参数值描述 |
参数 |
action |
recharge |
参数 |
username |
用户名(签名) |
参数 |
mobile |
手机号码(签名) |
参数 |
package |
套餐数额(签名) |
参数 |
orderid |
订单ID(签名) |
参数 |
timestamp |
时间戳(签名) 允许 10 分钟 统一以东 8 时间 |
参数 |
sign |
签名 |
返回值(JSON格式)
命名 |
类型 |
描述 |
code |
int |
代码(1为提交成功) |
message |
string |
消息描述 |
taskid |
string |
任务id,提交失败则没有 |
2.帐号余额查询
请求(POST 或者GET)
类型 |
参数名称 |
参数值描述 |
参数 |
action |
getbalance |
参数 |
username |
用户名(签名) |
参数 |
timestamp |
时间戳(签名) 允许 10 分钟 统一以东 8 时间 |
参数 |
sign |
签名 |
返回值(JSON格式)
命名 |
类型 |
描述 |
code |
int |
代码 |
message |
string |
消息描述 |
balance |
float |
剩余余额 |
3.充值状态查询
请求(POST 或者GET)
类型 |
参数名称 |
参数值描述 |
参数 |
action |
getreports |
参数 |
username |
用户名(签名) |
参数 |
count |
一次取数量(签名) |
参数 |
timestamp |
时间戳(签名) 允许 10 分钟 统一以东 8 时间 |
参数 |
sign |
签名 |
返回值(JSON格式)
命名 |
类型 |
描述 |
code |
int |
代码(1为提交成功) |
message |
string |
消息描述 |
reports+ |
array |
报告 |
taskid |
string |
任务id |
mobile |
string |
手机号码 |
state |
int |
状态(0失败, 1成功) |
message |
string |
消息 |
注意:状态获取后服务器则会删除状态
4.充值状态推送
请求(POST方式推送到配置的网址)
类型 |
参数名称 |
参数值描述 |
参数 |
taskid |
充值任务ID |
参数 |
mobile |
手机号码(签名) |
参数 |
state |
状态(签名) 1:成功 2:失败 |
参数 |
message |
消息(签名) |
参数 |
sign |
签名 |
注意:充值状态查询和充值状态推送两种方式只能选择其中一种
5. 获取话费包档位
请求(POST 或者GET)
类型 |
参数名称 |
参数值描述 |
参数 |
action |
getpackages |
参数 |
username |
用户名(签名) |
参数 |
timestamp |
时间戳(签名) |
参数 |
sign |
签名 |
返回值(JSON格式)
命名 |
类型 |
描述 |
code |
int |
代码 |
message |
string |
消息描述 |
packages+ |
float |
套餐 |
type |
string |
类型(cncm:中国移动 cncu:中国联通 cnct:中国电信) |
name |
string |
话费包 |
number |
int |
数值(用于充值请求) |
state |
int |
状态(1启用,0未启用) |
price |
int |
单价 |
6.状态码
数值 |
描述 |
0 |
未知错误 |
1 |
提交成功 |
1000 |
无此操作类型(action为空或不存在) |
1001 |
用户名为空 |
1002 |
用户名错误 |
1003 |
手机号码为空 |
1004 |
手机号码为空 |
1005 |
套餐不能为空 |
1006 |
时间戳不能为空 |
1007 |
不存在的套餐 |
1008 |
签名不能为空 |
1009 |
签名错误 |
1010 |
签名过期 |
1011 |
账号被冻结 |
1012 |
余额不足 |
1013 |
访问ip与备案ip不相同 |
1014 |
订单ID不能为空 |
1015 |
订单ID已存在 |
2001 |
不支持的手机号码 |
2002 |
手机号码已加入黑名单 |
2003 |
不支持的地区 |
3001 |
扣费失败 |
4001 |
系统内部故障 |
7. 签名说明
需要把apikey(登录系统获取)放到要签名的键值对中,按照asc排序键值对参数名排序,拼接键值对字符串(参数名小写),再用32位md5加密
注意:用户名请使用小写
如:
sign=md5(aaaa=aaaa&bbbb=bbbb&cccc=cccc&dddd=dddd)
PHP充值签名代码如下:
$sign = md5(sprintf(“apikey=%s&mobile=%s&orderid=%s&package=%s×tamp=%s&username=%s”,
$apikey,
$mobile,
$orderid,
$package,
date("YmdHis"),
$username));
GET方式地址如:
http://f.ihuyi.com/phone?action=recharge&username=testname&mobile=13800000000&orderid=xxxxxxxxx&package=10×tamp=1457954906&sign=e08ecdcedac8f9e07b1727e1005b8d32
8.PHP充值代码DEMO
$basicUrl = "http://f.ihuyi.com/phone?action=recharge&%s";
$username = 'testname';
$apikey = 'testapikey';
$mobile = '18801850000';
$package = 1;
$orderId = 'TEST_'.date("YmdHis").mt_rand(100, 1000);
$dataGet = array();
$dataGet['package'] = $package;
$dataGet['username'] = $username;
$dataGet['timestamp'] = date("YmdHis");
$dataGet['mobile'] = $mobile;
$dataGet['orderid'] = $orderId;
$dataGet['sign'] = md5(sprintf(“apikey=%s&mobile=%s&orderid=%s&package=%s×tamp=%s&username=%s”,
$apikey,
$mobile,
$orderid,
$package,
date("YmdHis"),
$username));
$dataReturn = array();
foreach ($dataGet as $key => $row) {
$dataReturn[] = sprintf("%s=%s", $key, $row);
}
$urlGet = sprintf($basicUrl, implode("&", $dataReturn));
$ch = \curl_init();
curl_setopt($ch, CURLOPT_URL, $urlGet); //定义表单提交地址
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30); //60秒
curl_setopt($ch, CURLOPT_HEADER, 1);
curl_setopt($ch, CURLOPT_REFERER, 'http://' . $_SERVER['HTTP_HOST']);
curl_setopt($ch, CURLOPT_POST, 0);
$data = curl_exec($ch);
curl_close($ch);
$res = explode("\r\n\r\n", $data);
$dataRet = $res[1];
if ($dataRet['code'] == 1) {
//提交成功
$apiTaskid = $dataRet['taskid'];
} else {
//提交错误处理
//.....
}
转载于:https://my.oschina.net/u/3095394/blog/796926
手机话费充值接口开发指南(含API文档,充值移动、联通、电信话费)相关推荐
- Apache PDFbox开发指南之PDF文档读取
转载请注明来源:http://blog.csdn.net/loongshawn/article/details/51542309 相关文章: <Apache PDFbox开发指南之PDF文本内容 ...
- 大牛推荐丨积分活动工具接口:积分商城api文档
什么是积分?自积分概念提出以来,积分活动已经成为一种非常流行的运营工具.对于积分,现在已经有一个比较完善和成熟的积分商城体系,在企业运营者的眼里,积分活动自然成为一种良好的积分商城运营模式. 利用积分 ...
- 【分享经验】手机话费充值接口接入指南(含话费API说明)
国庆前公司要上一个注册后可以领取手机话费的活动,一旦注册后就赠送其话费红包,主要是小额话费:1元.2元.5元.10元等小面值. 这其中需要实现话费充值的功能,百度搜罗了下,有几家是做接口服务的平台,但 ...
- Android官方SDK下载(含API文档)
下载Android官方SDK文档的方法: 1.昨天我按照方法二下好了一份,大家可以直接下载:http://yunpan.cn/cy7NNkgfUbfDr (提取码:6075) (如果链接失效,请提醒我 ...
- windows api中文文档_Web服务开发:Spring集成Swagger,3步自动生成API文档
目录: 1,Spring Boot集成Swagger 2,Swagger接口文档页面 3,常见问题和解决方法 在Sping开发REST接口服务时,API文档是不可缺少的一个重要部分.Swagger框架 ...
- swagger 修改dto注解_Web服务开发:Spring集成Swagger,3步自动生成API文档
目录: 1,Spring Boot集成Swagger 2,Swagger接口文档页面 3,常见问题和解决方法 在Sping开发REST接口服务时,API文档是不可缺少的一个重要部分.Swagger框架 ...
- 这些年我用过的API文档工具,个个是精品。
这些年我用过的API文档工具,个个是精品! 这些年用过不少API文档工具,也写过不少相关的文章,我发现哪种API文档工具更好用一直都是大家比较关心的话题.今天整理了下我曾经用过的7种API文档工具,每 ...
- SpringBoot2.x整合Swagger2 实现API文档实时生成
我们提供Restful接口的时候,API文档是尤为的重要,它承载着对接口的定义,描述等,本文主要介绍了SpringBoot集成Swagger2生成接口文档的方法示例,需要的朋友们下面随着小编来一起学习 ...
- 聚合API文档阅读帮助
聚合API文档阅读帮助 该文基于聚合云数据开放平台的API文档,目的使得开发者能够方便的快速了解我们这个API文档的结构,从而能够经行高效的开发. 该API文档总共有6个大类:国外API.国内API. ...
最新文章
- Html5 Json应用
- 利用 Pandas 将数据集中的某列文本拆分为多行
- 黄聪:php精度计算问题
- linux dev_info,Linux命令集-xfs_info
- 阿里面试官给你的一些忠告,这样做肯定错不了!附视频
- Python os模块文件操作(一)
- vue05-REST 请求
- php 计算上个月,如何使用PHP计算上一个月的今天
- Atom:一些有用的Packages和插件
- RS232 DB9串口设备
- 6. NMF方法及实例
- jwplayer.v7.1.4视频播放器的使用
- IP Routing 概述
- 视频转换器怎么将ogv格式转换成mp4
- 15---Mysql的多表+事务
- html如何设置下拉列表
- 大恒相机开发问题(错误码: -8)无法打开相机
- 五子棋java毕业设计论文_基于Java的五子棋游戏的设计毕业论文,课程设计,研究生文献...
- 大型分布式网站架构设计与实践
- 市场全线激活,一类币存在博弈机会
热门文章
- 第三节、AHK热键定义
- 曾差点威胁到 QQ 的 UC及校友录,没了,UC的加解密算法
- Excel技能培训之十三字符串操作函数mid,left,right,find,len,lenb,search,phonetic,extract
- Linux 中的 ~/. 表示的意思
- 2020最新短链接(防洪‘红’缩短网址)即视源码
- java获取chanel的ip_Netty:在消息中获取远程IP地址 - java
- 【实战篇:粘连物体分割——利用几何分割实现瓶盖分割检测】
- HP Jaserjet1007打印机在win7 64位下不能安装
- freeradius pap mysql_freeradius2.1+mysql搭建简明教程
- Idea中 .vue文件中的代码是灰色的