彩信/视频短信

产品详情

余额查询接口

1、接口描述

请求支持 POST 方法，字符编码为 utf-8。

2、请求地址

https://api.ihuyi.com/mms/v1/balance

3、请求头说明

参数名称	参数值描述	示例	类型	必填
Content-Type	内容类型，固定值	application/json	string	是

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
api_id	APIID(用户中心【富媒体短信】-【5G视频短信】-【产品总览】查看)	mms-xxxxxxxx	string	是
signature	请求验证加密签名(非彩信签名)；签名生成方式：仅公共参数以ASCII码从小到大排序值，key=value，多值以“&”隔开，拼接之后md5 32位小写；如：md5(api_id=xxxx&api_key=xxxx&request_id=xxxxxxxx&timestamp=xxxxxxx) APIKEY(用户中心【富媒体短信】-【5G视频短信】-【产品总览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	xxxxxxxxx	string	是
timestamp	东八时区;10位时间戳，时间允许相差±60S	1623643787	int	是
request_id	请求方请求ID，建议使用唯一ID，比如使用uuid；我方系统会2小时内去重验证处理，防止网络重复攻击；	xxxxxxxxxxxx	string	是

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	状态码，OK表示发送成功，其他则是错误	OK\|ParamError	string	是
message	消息内容	请求成功\|参数错误	string	是
data	数据		array	否
product_id	产品ID	1	int
product_name	产品名称	xxxxxx	string
balance	余额	2	float

6、响应状态码说明

code	msg
OK	请求成功
ParamError	参数错误
AccessKeyIDNotExist	AccessKeyID不存在
UserIDNotExist	用户ID不存在
AmountError	数额错误(超出许可范围)
TimestampError	时间错误(超出许可范围)
ProductIDNotExist	产品ID不存在
TypeNotExist	类型不存在
RemarkError	备注错误
RequestIDExisted	请求ID已存在
NonceExisted	随机数已存在
SingError	签名错误
SignExpired	签名过期
BalanceNotEnough	余额不足
PackIDExisted	资源包ID已存在
SystemError	系统异常
InputDataInvalid	请求参数异常

7、GET传参示例

不支持

8、响应示例

示例（成功）

{    "code":
            "OK"
        ,        "message":
            "请求成功"
        ,        "data":
            [    {    "product_id":
                1
                    ,        "product_name":
                "xxxxxx"
                    ,        "balance":
                "2"
                        }
    ]            }

示例（失败）

{"code":"ParamError",}

9、PHP生成动态密码方式代码示例

$api_id = 'mms-xxxxxxxx';
$api_key = 'xxxxxxxxxxxxxxxx'; //可登录用户中心查看
$request_id = 'xxxxxxxxxxxx';
$timestamp = '1623643787';
$password=md5('api_id='.$api_id.'&api_key='.$api_key.'&request_id='.$request_id.'&timestamp='.$timestamp);
$password=md5('api_id=mms-xxxxxxxx&api_key=xxxxxxxxxxxxxxxx&request_id=xxxxxxxxxxxx&timestamp=1623643787');

//注意：所有字符编码统一为UTF-8

彩信/视频短信

余额查询接口

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

9、PHP生成动态密码方式代码示例

10、代码示例

5分钟快速自助开通免费体验账户