API: SMS/Appextend - 短信簽名管理API

概覽

sms/appextend 是 SUBMAIL 的短信簽名查詢、創(chuàng)建、更新、和刪除 API。

使用 sms/appextend GET方式 可以查詢當前appid或目標appid下的簽名列表，包括簽名、審核狀態(tài)。
使用 sms/appextend POST方式 可以創(chuàng)建短信簽名并提交審核。
使用 sms/appextend PUT方式 可以更新短信簽名資料信息，如果簽名是駁回狀態(tài)，會更新短信簽名至待審核狀態(tài)。
使用 sms/appextend DELETE方式 可以刪除短信簽名。

URL

https://api-v4.mysubmail.com/sms/appextend

支持格式

是否需要授權(quán)

是

參閱 API 授權(quán)和驗證機制

sms/appextend GET 方法請求參數(shù)

成功返回

{
    "status": "success",
    "smsSignature": [
        {
            "appid": "appid",
            "smsSignature": "【簽名1】",
            "status": 1   //0=審核中、1=審核已通過、其他=審核不通過
        },
        {
            "appid": "appid",
            "smsSignature": "【簽名2】",
            "status": 1
        },
        ...
    ]
}

失敗返回

{
    "status": "error",
    "code": 154,
    "msg": "No available SMS signature"
}

sms/appextend POST 方法請求參數(shù)

請求方式
http post
content-type: form-data

注：如果同一APPID下簽名已存在，則無法提交新簽名。

成功返回

{
    "status": "success",
}

失敗返回

{
    "status": "error",
    "code": 127,
    "msg": "Sms Signature already exists"
}

sms/appextend PUT 方法請求參數(shù)

請求方式
http put
content-type: form-data

成功返回

{
    "status": "success",
}

失敗返回

{
    "status": "error",
    "code": 154,
    "msg": "No available SMS signature"
}

sms/appextend DELETE 方法請求參數(shù)

成功返回

{
    "status": "success",
}

失敗返回

{
    "status": "error",
    "code": 154,
    "msg": "No available SMS signature"
}

錯誤代碼

參閱 API 錯誤代碼