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