提交订单 - 云通信云讯科技

优先必读

1:	用户账户Id(accountSID)和用户账户授权令牌(authToken)在哪获取？
提示:	用户登录平台，在导航菜单管理-控制台-开发者主账号下面, 或用户登录平台，在导航菜单管理-体验-功能体验-账号信息下面。(两种获取到账户信息是一样的)
2:	应用ID在哪获取？
提示:	1.如果使用沙箱环境http://sandbox.ytx.net，用户登录平台，在导航菜单管理-体验-功能体验-测试应用下面。 2.如果使用正式环境http://api.ytx.net，用户登录平台，在导航菜单管理-应用管理-应用列表下，若没有应用，需要创建应用。(注:应用上线后,应用ID才有效)
3:	状态回推的相关设置？
提示:	(注:沙箱环境http://sandbox.ytx.net,没有相关设置) 在使用正式环境http://api.ytx.net下,用户登录平台，在导航菜单管理-应用管理-创建应用-设置相应的回调地址。
4:	IP鉴权地址的相关配置？
提示:	(注:沙箱环境http://sandbox.ytx.net,没有相关设置) 在使用正式环境http://api.ytx.net下,用户登录平台，在导航菜单管理-应用管理-创建应用-设置相应的IP白名单。 (注:如测试使用ip白名单,切记将测试主机ip加入到白名单中) 有需要对用户接口发送的服务器进行ip限制，就可以使用ip鉴权进行配置。多个ip使用英文,号分隔。配置空表示不鉴权。
5:	签名sign的加密格式是什么？
提示:	MD5加密（账户Id + 账户授权令牌 +时间戳)，例如：Sign=AAABBBCCCDDDEEEFFFGGG *时间戳需与Authorization中时间戳相同(时间戳格式:yyyyMMddHHmmss) 注:MD5加密32位,无论大小写
6:	应用验证失败原因(-205)与解决办法？
提示:	1.应用ID与环境不匹配: ①体验里应用ID与沙箱环境http://sandbox.ytx.net使用 ②自己创建的应用的应用ID与正式环境http://api.ytx.net使用 2.设置ip白名单: ①去掉白名单在测试 ②将测试主机ip加入到白名单中 3.应用未开通相应的功能或应用没有上线。
7:	提交测试时注意
提示:	在测试之前联系产品经理开通测试通道。

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://api.ytx.net
沙箱环境	http://sandbox.ytx.net

公共请求参数：

名称	类型	是否必须	描述
accountSID	string	是	云通信平台用户账户Id：对应管理控制台中的 ACCOUNT SID
authToken	string	是	云通信平台用户账户授权令牌：对应管理控制台中的 AUTH TOKEN
version	string	是	云通信API接口版本目前可选版本：201612
func	string	是	功能所属分类call【语音类】/sms【消息类】/traffic【流量类】/account【账户类】当前功能属：traffic
funcURL	string	是	业务功能的各类具体操作分支当前功能属：Traffic.wx
Authorization	string	是	云通信平台API接口，包头验证信息：base64加密(账户Id + "\|" + 时间戳) 说明：时间戳有效时间为24小时格式"yyyyMMddHHmmss"，如：20140416142030
Sign	string	是	云通信平台API接口，API 验证参数：MD5加密（账户Id + 账户授权令牌 +时间戳) URL后必须带有Sign参数，例如：Sign=AAABBBCCCDDDEEEFFFGGG 时间戳需与Authorization中时间戳相同注:MD5加密32位,无论大小写

请求参数

名称	类型	是否必须	描述
action	string	是	API接口名称，默认值：flowOrder（区分大小写）
appid	string	是	用户登录云通信平台后，所创建的应用编号appid，若想调用当前流量充值接口，则此应用必须包含有流量功能，否则调用失败。
phone	string	是	接收充值的手机号( 例：153****2082）
flowCode	string	是	流量代码。此代码通常情况下可以由下面的规则生成.特殊情况根据我方给出的代码为准。第1位表示号码所属运营商[1移动 2电信 3联通] 第2-3位表示充值通道[全国口或者省口],全国口[QG],省口用手机归属地字母代替.具体见省份代码对应表第4-9位共6位表示充值流量包大小，不够6位左补0.eg:001024 表示1G 第10位表示流量的属性[1标准包 2红包 3快餐 4转增] 第11位表示流量支持的漫游情况 0全国漫游 1省内漫游 eg: 1BJ00001020 表示移动北京省网10M红包支持全国漫游 2QG00001011 表示电信全网10M标准包支持省内漫游
customParm	string	否	用户自定义参数（主要可用为商户传给平台的唯一订单编号，本平台不校验订单唯一性,该参数在回调此订单状态时返回）

省份代码对应表

省份	代号
全国	QG
安徽	AH
北京	BJ
重庆	CQ
福建	FJ
广东	GD
甘肃	GS
广西	GX
贵州	GZ
湖北	HE
河北	HJ
黑龙	HL
湖南	HX
海南	HQ
河南	HY
吉林	JL
江苏	JS
江西	JX
辽宁	LN
内蒙	NM
宁夏	NX
青海	QH
四川	SC
山东	SD
上海	SH
山西	SJ
陕西	SS
天津	TJ
西藏	XZ
新疆	XJ
云南	YN
浙江	ZJ

响应参数

名称	类型	示例值	描述
statusCode	string	0	发送结果错误码
statusMsg	string	提交成功	发送结果状态描述
requestId	string	2016010000000219	为验证码发送成功后返回的requestId唯一标识

请求包头


1	URL
2	/{version}/sid/{accountSID}/{func}/{funcURL}?Sign={Sign}
3	HTTP标准包头字段
4	Accept:application/json;
5	Content-Type:application/json;charset=utf-8;
6	Authorization:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

报文示例

JSON示例


1	POST /201612/sid/abcdefghijklmnopqrstuvwxyz012345/traffic/Traffic.wx?Sign=C1F20E7A9733CE94F680 C70A1DBABCDE HTTP/1.1
2	Host:127.0.0.1:46376
3	content-length: 132
4	Accept:application/json;
5	Content-Type:application/json;charset=utf-8;
6	Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=

7	{"action":"flowOrder","phone":"13911281234","flowCode":"2QG00001011","appid": "ff8080813fc70a7b013fc72312324213","customParm":""}

请求示例

.Net


1	string jsonData= {\"action\":\"flowOrder\",\"phone\":\"18810207016\",\"flowCode\":\"2QG00001011\",
2	\"appid\":\"3215ad6a7d0247ae8b39728b854fa59c\",\"customParm\":\"\"}";
3	string url = "/call/Traffic.wx";
4	string result = CommenHelper.SendRequest(url, jsonData);
5	备注： SendRequest方法在CommenHelper.cs文件里做了封装。详细介绍请点击这里；完整demo示例，下载。

PHP


1	$demo = new ytx();
2	$phone= "13800000000";
3	$flowCode= "2QG00001011";
4	$effectStartTime= "1";
5	$effectTime= "1";
6	$ret = $demo->traffic($phone, $flowCode);下载。

响应示例

JSON示例


1	HTTP/1.1 200 OK
2	Content-Length: 85
3	{ "statusCode":"0","statusMsg":"提交成功","requestId":"2016010000000205"}

异常示例

JSON示例


1	HTTP/1.1 200 OK
2	Content-Length: 61
3	{"statusCode":"-2","statusMsg":"缺少必要参数","requestId":""}

错误码示例

错误码	错误描述	解决方案
0	提交成功
-1	号码无效
-2	缺少必要参数	调用接口时，请传入足够的参数
-3	无效action	传入正确的action
-4	无效的JSON	请遵守正确json语法
-100	异常错误	异常错误
-101	参数不合法	传入符合要求的参数
-102	电话号码不合法	传入正确的电话号码
-200	无此用户	登录官网开通服务账号
-201	用户状态失效	登录官网重新激活服务账号
-202	包头验证信息错误	包头验证信息超时，默认有效时间十分钟，请在有效时间内完成请求
-203	AuthToken验证失败	登录官网获取正确的AuthToken
-204	账户余额不足	登录官网充值
-205	应用验证失败	详情请看[优先必读]
	未知错误	联系客服，反应相关问题，促进更好的使用体验。