API: Factor/mobile_online - 運(yùn)營(yíng)商在網(wǎng)時(shí)長(zhǎng)
概覽
Factor/mobile_online
是submail的運(yùn)營(yíng)商在網(wǎng)時(shí)長(zhǎng)API,查詢請(qǐng)求手機(jī)號(hào)的在網(wǎng)時(shí)長(zhǎng)。
URL
<主> http://tpa.mysubmail.com/factor/mobile_online
<備> https://tpa.mysubmail.com/factor/mobile_online
http請(qǐng)求方式
請(qǐng)求方式 | content-type 設(shè)置 |
---|---|
http post | multipart/form-data 、x-www-form-urlencoded 、application/json |
signature創(chuàng)建規(guī)則
1. 請(qǐng)將以下參數(shù)按照字段升序(A-Z)排列 appkey 、mobile 、timestamp
2. 創(chuàng)建簽名字符串 :以"key=value" + "&"(連接符)+ "key=value" 的方式連接所有參數(shù)
3. 創(chuàng)建簽名:拼接簽名字符串示例string = "appkey=xxxx&mobile=xxxx×tamp=xxxxxxxxxx",然后使用sha256(string)創(chuàng)建簽名
注:中文需要使用urlencode處理后再參與創(chuàng)建簽名
請(qǐng)求參數(shù)
參數(shù) | 類型 | 是否必需 | 默認(rèn) | 描述 |
---|---|---|---|---|
appid | string | 必需 | 無(wú) | 在 SUBMAIL 身份認(rèn)證服務(wù)中創(chuàng)建并且認(rèn)證通過(guò)的應(yīng)用 ID |
timestamp | string | 必需 | 無(wú) | UNIX 時(shí)間戳 |
signature | string | 必需 | 無(wú) | 簽名,詳細(xì)規(guī)則看下方介紹 |
mobile | string | 必需 | 無(wú) | 電話號(hào)碼 |
返回參數(shù)格式
jsonString
代碼示例
詳情請(qǐng)查詢demo示例文檔
響應(yīng)消息
API請(qǐng)求失敗
{
// 狀態(tài)描述
'status' : 'error' ,
// API流水號(hào)
'send_id' : "********************************",
// API返回的狀態(tài)碼 詳情查看 API錯(cuò)誤代碼與描述 文檔
'code' : 1201 ,
// API返回的描述
'msg' : 'Incorrect APP ID.' ,
}
{
"status": "error",
"send_id": "********************************",
"code": "1217",
"msg": "API Gateway Error:手機(jī)號(hào)碼格式錯(cuò)誤(******)"
}
API請(qǐng)求成功
{
"status": "success",
"send_id": "********************************",
"result": {
//在網(wǎng)時(shí)長(zhǎng)
"time": "(24,+]"
}
}
注:因在網(wǎng)時(shí)長(zhǎng)屬于個(gè)人隱私,不輸出具體的值,以區(qū)間為準(zhǔn),單位為月,+表示:以上