订单查询 - 云通信云讯科技

云讯API索引

订单查询

xunzhong.orderQuery

此接口依据用户提供的订单编号查询该订单的流量充值结果，用于长时间未收到回调结果情况下，向平台发起查询请求（建议等待系统回调结果，此接口不建议频繁使用，查询频率限制为每分钟1次）

优先必读	公共参数	请求参数	响应参数	请求包头
报文示例	请求示例	响应示例	异常示例	错误码示例

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.应用未开通相应的功能或应用没有上线。

请求地址：

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

公共请求参数：

名称	类型	是否必须	描述
accountSID	string	是	云通信平台用户账户Id：对应管理控制台中的 ACCOUNT SID
authToken	string	是	云通信平台用户账户授权令牌：对应管理控制台中的 AUTH TOKEN
version	string	是	云通信API接口版本目前可选版本：201512
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接口名称，默认值：getTrafficResult（区分大小写）
appid	string	是	用户登录云通信平台后，所创建的应用编号appid，若想调用当前流量充值接口，则此应用必须包含有流量功能，否则调用失败。
requestId	string	否	订单编号，最多支持100个，用半角逗号分隔( 例：2016010000000219,2016010000000220）requestId和customParm参数任选其一。
customParm	string	否	自定义参数，最多支持100个，用半角逗号分隔( 例：2016010000000219,2016010000000220）requestId和customParm参数任选其一。

名称	类型	示例值	描述
requestId	string	2016010000000219	为验证码发送成功后返回的requestId唯一标识
appid	string	cbc6ceb21fd34664b6e452ca2aa40b3f	appid
trafficSts	string	1	发送结果错误码 1：充值成功 -1：充值失败 0 充值中
remark	string	成功	发送结果状态描述
mobile	string	188****0804	充值手机
oriAmount	string	2.94	消费金额


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":"getTrafficResult","requestId":"2016010000000219,2016010000000220","appid": "ff8080813fc70a7b013fc72312324213"}

.Net


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

PHP


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

JSON示例


1	HTTP/1.1 200 OK
2	Content-Length: 85
3	{"requestId":"2016010000000205","appid":"cbc6ceb21fd34664b6e452ca2aa40b3f", "trafficSts":"1","remark":"成功","mobile":"188****0804","oriAmount":"2.94"}

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	应用验证失败	详情请看[优先必读]
	未知错误	联系客服，反应相关问题，促进更好的使用体验。