常州发布信息的有什么网站,广丰网站建设,惠州淘宝网站建设,河北怀来县建设局网站移动流量平台概述又拍云手机流量营销平台#xff0c;整合移动、电信、联通三大运营商流量资源#xff0c;将强大的流量营销服务#xff0c;通过接口等形式提供给商家合作伙伴#xff0c;帮助商家开展品牌宣传、APP/游戏/微信公众号/网站的拉新与促活等多种营销活动。通过接…移动流量平台概述¶又拍云手机流量营销平台整合移动、电信、联通三大运营商流量资源将强大的流量营销服务通过接口等形式提供给商家合作伙伴帮助商家开展品牌宣传、APP/游戏/微信公众号/网站的拉新与促活等多种营销活动。通过接入又拍云流量营销平台商家可以获得更多流量、用户和收益而商家提供的活动也让用户获得了三网通用流量和更加丰富的活动体验。产品特点¶1.三网通用成本优势覆盖面广2.快速对接、全流水、易对账、精结算应用场景¶1.APP 下载赠流量2.微信公众号增粉3.奖品礼券4.流量加油站5.积分兑换流量6.活动比赛送流量7.流量红包8.员工福利对接说明¶1.请联系商务(Tel:0571-89775132)确定您的应用场景需求获取对应流量报价2.注册又拍云账号如果您已有账号请登录 又拍云控制台 完成企业/个人认证3.前往导航 工具箱 手机流量营销页面开通该服务(开通邮件中包含接口地址)4.通过流量营销控制台配置回调地址5.出口 IP 出于安全考虑暂不支持控制台配置可联系我司商务完成生产环境联调业务交互流程:接口文档¶又拍云手机流量平台接口入口地址统一为https://ptp-api.upyun.com请求接口时统一使用 POST 方法 文档类型统一为 Content-Type: application/json使用 JSON 格式发送请求 响应结果也会以 JSON 格式返回文档中接口的请求地址只包含路径部分实际请求时需要加上统一入口地址 https://ptp-api.upyun.com。文档中描述签名计算时都是先正序排序(给出的示例字符串已经是排序后的结果)再做 SHA1 运算。本文档一共描述了四个接口和一个充值回调说明接口如下获取签名 POST /refreshToken提交订单 POST /chargeOrder查询订单状态 POST /seekOrder查询余额 POST /getMyBalance针对以上接口目前提供了 php 版本 sdk用于提供接口调用示例 各企业用户可以根据自己的需要进行封装完善错误处理下载地址点击下载。接口详情¶1.获取计算签名需要的 token接口说明该接口用于获取 token调用其他接口时需要使用 token 计算签名。由于 token 需要在后续的接口请求中全局共享所以在并发请求的场景下建议将 token 保存在 Redis/Mysql 等第三方存储中请求地址POST /refreshToken请求参数名称类型是否必须描述appkeyString必须appkey由又拍云提供可以登录手机流量后台查看appsecretString必须appsecret由又拍云提供可以登录手机流量后台查看请求示例curl https://ptp-api.upyun.com/refreshToken -H Content-Type: application/json -d {\appkey\: \your_appkey_put_here\, \appsecret\: \your_appsecret_put_here\}响应参数名称类型示例值描述codeString200响应状态码200 表示正常其他详见错误码tokenStringXsdOpxqudzMnw用于签名计算需要的 tokentoken 默认有效期为 24 小时仅最后一次请求接口生成的 token 才有效infoString请求成功响应示例{code: 200,token: XsdOpxqudzMnw,info: 请求成功}2.创建订单接口说明创建手机流量充值订单请求地址POST /chargeOrder请求参数名称类型是否必须描述appkeyString必须E1KRHcKd3qoef8V1mobileString必须被充值手机号进行 AES 对称加密再 base64 转码后的值一次只允许一个手机号码见示例程序prodcodeString必须流量包的产品编号custnoString必须客户自定义的订单号用于客户内部记录订单长度必须小于30 且每次充值编号不重复signString必须根据 token 和请求参数计算的签名签名规则见算法说明部分 (示例程序下载)prodtimeInteger选填流量时段1 表示全时段流量0 表示闲时流量默认为全时段流量prodstandardInteger选填用于区分网络类型可选值分别为7表示全部网络类型3表示 2g 和 3g 两种网络类型1表示 2g 网络类型默认值为7响应参数名称类型示例值描述codeString200响应状态码200 表示创建订单成功410 511 必须再次查询订单确认其他错误码视为创建失败系统响应超时等其他非正常响应需要调用查询订单接口确认custnoString20150238829客户订单号和请求值一致ordernoString2016298237019又拍云平台的订单号infoString充值成功算法说明计算手机号的 AES 对称加密再 base64 转码后的值将接口请求参数按照请求参数名称正序排序;将请求参数和请求参数值拼接成字符串appkey${YourAppKey}custno${YourCustno}mobile${YourAesEncodedMobile}prodcode${YourPrdcode}token${YourToken(将字符串中的变量${...}部分替换成实际值即可)对拼接后的字符串进行SHA1指纹运算得到的 16 进制字符串 b5cd94c99e3e576f5e2ca0e66ee3da670cb1c62b 便是 sign 值示例参数拼接后的字符串为appkey3P83lWwkoV15yZVTcustno20151123114702mobile8mBGFNfe1o/rzAx2Ost2IQprodcodeCMCC_10tokenVqHAab3JYXBDkCoO(注意手机号是 aes 加密再 base64 编码后的)进行 SHA1 运算得到的 sign 值为8b05f52e605c7ab89a895eb730cacab4cbeabd4c响应示例{code: 200,custno: 20150238829,orderno: 2016298237019,info: 充值成功}3.查询订单状态接口说明查询充值订单当前的状态用于确认是否充值成功请求地址POST /seekOrder请求参数名称类型是否必须描述custnoString必须客户提交的订单号appkeyString必须鉴权账号signString必须签名签名规则为将 appkey${YourAppKey}custno${YourCustno}requesttime${YourReqestTime}TOKEN${YourToken} 中${...}变量部分替换为实际值再进行 SHA1 运算。如果请求参数不包含 requesttime计算签名则不需要该值requesttimeString否查询的时间点该参数为可选参数格式为YYYY-MM-DD HH:mm:ss当传递该参数时我们会在给定时间点的前后 1 个小时范围内查询如果未传该参数我们将在最近一周的订单中查询响应参数名称类型示例值描述codeString200响应状态码200 表示充值成功430 516 530 表示充值失败511 必须人工再次确认其他错误码视为充值中custnoString20150238829客户自定义订单号infoString成功响应示例{code: 200,custno: 2015823871239,info: 充值成功}4.查询余额请求地址POST /getMyBalance请求参数名称类型是否必须描述appkeyString必须signString必须签名算法为 appkey${YourAppKey}TOKEN${Yourtoken} 中${...}变量部分替换实际值再进行 SHA1 运算得到的字符串便为 sign 值响应参数名称类型示例值描述codeString200响应状态码balanceFloat100.00账户余额(包含冻结金额)freezeFloat20.00冻结金额正在交易的订单金额availBalanceFloat80.00实际可用余额(不包含冻结金额)响应示例{code: 200,balance: 100,freeze: 20,availBalance: 80}充值回调说明¶客户需要在又拍云手机流量后台填写充值回调地址并注意防火墙配置不能屏蔽又拍云服务器地址。配置成功后每次充值后又拍云会向该地址发送 POST 请求请求的数据格式为 application/json请求参数名称类型是否必须描述codeString必须响应状态码200 表示充值成功430,530 表示充值失败其他错误码或异常信息表示充值中ordernoString必须又拍云平台的订单号custnoString必须客户自定义订单号infoString必须描述信息signString必须签名客户可以使用该值校验请求是否合法强烈建议接收充值回调时进行校验。签名规则为将 code${Code}custno${YourCustno}info${Info}orderno${OrderNo}token${YourToken} 字符串中的变量部分${...}替换为请求参数中的值再对得到的字符串进行 SHA1 签名客户接受请求成功后需要响应如下 json 值{info: 1}否则又拍云将隔 1 分钟再重试一次一共回调 3 次错误码说明¶注需要留意每个接口响应参数说明中的 code 处理方式错误码说明错误码说明200成功201充值中410运营商返回超时422用户状态异常430订购/充值失败502sign签名错误503余额不足504非法的回调地址505手机号不合法506用户不能订购该套餐507接口参数异常508令牌鉴权不通过509客户未认证授权510查询太频繁511内部异常此时对订单的查询、充值等操作等需要联系客户再次确认512订单号重复513运营商请求超时514ip不在白名单515该客户不存在516不存在此订单517无法识别的手机号519当前appkey或appsecret错误520活动不存在526合同不在有效期527token不在有效期530订购/充值失败531签名不通过532订单号长度超过30533aes加密有误
