采用HTTP協(xié)議post方法。
環(huán)境地址,即調(diào)用接口(API)時(shí),都通過訪問該地址,來獲取該接口需要獲取的數(shù)據(jù):
l 正式環(huán)境:
l 聯(lián)系商務(wù)提供相關(guān)
調(diào)用API ,Http協(xié)議頭參數(shù)。系統(tǒng)參數(shù)詳細(xì)介紹如下;應(yīng)用參數(shù)由于不同 API 各自不同
名稱 |
類型 |
是否必須 |
描述 |
CommandID |
String |
是 |
0x00000001~0x89999999 平臺(tái)分配的業(yè)務(wù)調(diào)用指令 |
Key |
String |
是 |
MD5(UserName+Password+Timestemp) |
Timestemp |
String |
是 |
MMddHHmmss每次請求都需要變化,這樣出來的MD5值不會(huì)有重復(fù) |
UserName |
String |
是 |
友信云平臺(tái)分配賬號(hào) |
MessageId |
String |
是 |
消息ID 32位長度的字符串做為本次通信唯一值 |
ContentIsZip |
String |
是 |
如果群發(fā)內(nèi)容比較大加快傳輸需要對包體進(jìn)行GZIP壓縮,默認(rèn)false |
Http頭信息與請求相同 CommandID 會(huì)由0x0000001 變?yōu)?span> 0x80000001內(nèi)容為JSON數(shù)據(jù)格式
應(yīng)答體說明
{ "body": "", "description": "", "result": 0 } |
名稱 |
類型 |
是否必須 |
描述 |
result |
String |
是 |
運(yùn)行結(jié)果0成功,其它失敗,失敗后body無任何信息 |
body |
String |
是 |
根據(jù)具體請求返回不同的結(jié)果,例:業(yè)務(wù)獲取余額 body為余額,業(yè)務(wù)為獲取狀態(tài)報(bào)告,body為狀態(tài)報(bào)告集合,為務(wù)為獲取上行,body為上行集合。具體參數(shù)解析祥見業(yè)務(wù) |
description |
String |
是 |
失敗后的中文描述 |