万维易源-三网手机话费充值

三网手机话费充值 官方自营会员接口

累计调用

40万+

会员接口交流群： 1054956818 查看演示

查看加密签名方式 二、请求参数/ Request parameter

非文件上传的POST时，请设置headers['Content-Type'] = 'application/x-www-form-urlencoded', 并把对象形式的数据转成查询字符串
文件上传的POST时，请设置headers['Content-Type'] = 'multipart/form-data'

1、系统级参数（所有接入点都需要的参数）：展开收起

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。可选【简单密钥方式】,在url后带上showapi_appid和showapi_sign即可
showapi_timestamp	String	20141114142239	否	客户端时间。格式yyyyMMddHHmmss,如20141114142239 为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起

参数名称	类型	示例值	必须	描述
phone	String	1808844xxxx	是	要充值的手机号码
money	String	20	是	充值金额，支持20、30、50、100、200、300、500元的面额。
orderId	String		否	用户自定义的订单号，不可重复，长度不超过32位，可为英语或数字。如不输入，则系统生成默认值。
callback	String		否	回调地址，若提交该参数，请指定协议名，如http
...

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口 -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起

名称	类型	示例值	描述
ret_code	Number	0	0为提交订单成功，其他失败
remark	String	订单提交成功，正在充值！	提示信息
orderId	String	616549843214984161	订单号，若未提交过则此处返回的是一个随机值
status	String	charging	订单状态：success表示充值成功,charging表示正在充值，fail表示充值失败，refund为充值渠道主动返销后已退款的状态
cause	String		充值失败原因，
alarm	Number	0	0表示程序运行无误，1表示程序发生异常需人工对单
price	Number	99.87	定单价格
code	Number	100001	100001:订单提交成功 101012:充值号码不可为空 101013:充值号码错误 101014:不支持充值的号段 101015:没有该号码的归属地 101016:不支持该地区的充值 102001:充值面值错误，请更换支持的话费面值 103001:订单号错误，请更换订单号 104001:Callback回调地址错误 105001:获取运营商信息失败 106001:没有获取到合适的充值渠道，需联系客服处理 106002:充值渠道配置出错，需联系客服处理 106003:询价失败，需联系客服处理 106004:询价失败，需联系客服处理 106005:询价失败，需联系客服处理 107001:访问账户失败，一般情况下是因余额不足造成的，这时ret_code值为-3 108001:充值发生未知异常，需联系客服处理 109001:订单提交失败，请更换订单id重新提交 108002:充值渠道处理异常，请联系客服核对订单
...

四、请求示例/ Request example 查看使用向导查看我的showapi_appid与showapi_sign 丨

五、返回示例/ Return example

{
	"showapi_res_code": 0,
	"showapi_res_error": "",
	"showapi_res_id":"ce135f6739294c63be0c021b76b6fbff",
    "showapi_res_body": {
		"ret_code": 0,
		"remark": "订单提交成功，正在充值！",
		"orderId": "616549843214984161",
		"status": "charging\n",
		"cause": "",
		"alarm": "0",
		"price": 99.87,
      "code":100001
	}
}

一个会员资源包即可调用【所有会员接口】
注册即免费送会员包（流量次数限制）
if （会员包到期 or 次数用完 or 流量用完） then 会员包失效 end
可购买多个资源包，会自动递延生效串联使用

三网手机话费充值官方自营会员接口

1、接口介绍

2、使用场景

3、产品优势对比

4、我们的实力

5、合作伙伴

一、接入点/ API point

查看加密签名方式二、请求参数/ Request parameter

三、返回参数/ Return parameter

四、请求示例/ Request example 查看使用向导 查看我的showapi_appid与showapi_sign 丨

五、返回示例/ Return example

提供方联系方式/ Contact Information

易源·API市场

三网手机话费充值 官方自营 会员接口