API: 彩信簽名管理API

概覽

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

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

URL

https://api-v4.mysubmail.com/mms/signature

支持格式

是否需要授權(quán)

是

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

mms/signature GET 方法請求參數(shù)

成功返回

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

失敗返回

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

mms/signature POST 方法請求參數(shù)

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

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

成功返回

{
    "status": "success",
}

失敗返回

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

mms/signature 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 錯誤代碼