![]()
一、快递100短信发送接口
![]()
1.1 请求地址
<p>http://apisms.kuaidi100.com:9502/sms/send.do</p>
或
<p>https://apisms.kuaidi100.com/sms/send.do</p>
![]()
1.2 请求类型
POST
![]()
1.3 请求参数
请求参数（header）
| 名称 | 类型 | 默认值 |
|---|---|---|
| Content-Type | string | application/x-www-form-urlencoded |
请求参数（body）
| 名称 | 类型 | 是否必填 | 示例值 | 参数描述 |
|---|---|---|---|---|
| sign | String | 是 | 4BBDE07660E5EFF9 0873642CFAE9A8DD | 加密签名信息：MD5(key + userid)；加密后字符串转32位大写 |
| userid | String | 是 | 9974ef2c377a4dbt9 c8g1b64dd6311ea | 我方分配给贵司的的公司编号，请<a href="https://api.kuaidi100.com/register/enterprise" target="_blank">申请企业版</a>获取 |
| seller | String | 是 | 快递100 | 商户名称签名；最好用简称，该字段信息会在短信标签处显示。不要超过5个字符 |
| phone | String | 是 | 13568688888 | 接收短信手机号 |
| tid | long | 是 | 11 | 短信模板ID |
| content | String | 是 | {“接收人姓名”:”王帅”, “公司名”:”快递100”, “快递单号”:”154893238584”, “url”:https: //api.kuaidi100.com/home”} | 短信模板替换内容 |
| outorder | String | 否 | 143255893 | 外部订单号：当该短信发送模板有回调地址时，外部订单号会返回给调用者，方便用户更新数据 |
| callback | String | 否 | http:// xxx/callback | 回调地址：如果客户在发送短信时填写该参数，将按照这个参数回调短信发送状态；如果为空，将按照模板配置的地址回调短信发送状态；如果两个参数都不填写，将不会回调通知状态 |
![]()
1.4 请求参数示例
sign= "4BBDE07660E5EFF90873642CFAE9A8DD" userid= "9974ef2c377a4dbc9c8c1b64dd6311ea" seller= "快递100" phone= "13566688888" tid= 11 content = { "接收人姓名": "王帅", "公司名": "快递100", "快递单号": "154893238584", "url": "http://www.kuaidi100.com" } outorder = "143255893"![]()
1.5 返回结果
| 参数名称 | 数据类型 | 示例值 | 参数描述 |
|---|---|---|---|
| status | integer | 1 | 状态值：0-表示失败；1-表示成功 |
| data | object | 返回数据信息 | |
| msg | String | 信息内容：返回具体的信息体描述 | |
| extra | object | 附加信息 | |
| total | integer | 该值表示所数据的总条数 |
![]()
1.6 返回数据示例
{ "status": 1, "data": "", "msg": "短信发送中……", "extra": "", "total": 0}![]()
二、快递100短信回调请求
![]()
2.1 回调信息
| 参数名称 | 数据类型 | 示例值 | 参数描述 |
|---|---|---|---|
| status | integer | 1 | 状态值：0-表示失败；1-表示成功 |
| Θdata | object | 返回数据信息：短信发送状态 | |
| └ outorder | String | 143255893 | 传入的外部订单号 |
| └ message | String | OK | 附加信息 |
| └ status | String | 发送成功 | 短信发送状态：发送成功、发送失败、接收成功、接收失败 |
| └ sign | String | 返回校验信息：MD5(id + phone + outorder)；校验方式是MD5加密的：模板ID+手机号+外部订单号。用户可根据加密签名判断是否进行处理请求 | |
| msg | String | 信息内容：返回具体的信息体描述 | |
| extra | object | 附加信息 | |
| total | integer | 该值表示所数据的总条数 |
![]()
2.2 返回数据示例
{ "status": 1, "data": { "outorder": "143255893", "message": "", "status": "发送成功" }, "msg": "短信发送结果信息", "extra": "", "total": 0}![]()
2.3 请求报文响应示例
{ "status": true}![]()
一、产品介绍
短信接口为快递100的企业客户提供短信发送功能，调用方首先通过我们的企业管理后台创建短信模板，快递100会根据国家相关法律法规对短信模板进行审核。审核通过后企业可发送短信给合作伙伴、客户等。
![]()
二、短信API应用场景
企业寄件或者电商发货后，通过短信的方式通知收件人已经发货；
根据物流轨迹状态，可告知收件人物品在途情况，提醒收件人及时签收；
可向顾客发送营销短信、活动推广短信等，推广产品和提高品牌形象。
![]()
三、短信API收费模式
![]()
1. 收费方式
短信服务使用预充值付费方式，商户在注册快递100账号后可以在企业管理后台<a href="https://api.kuaidi100.com/service/message" target="_blank">查看套餐</a>并购买短信数量。
![]()
2. 收费价格
短信服务收费标准是0.04元/条。
企业每次成功调用接口，都会扣除短信数量，若数量已经扣除完毕，需要重新充值购买。
![]()
3. 开具发票
快递100支持开具增值税发票，用户购买完成后可在企业管理后台-费用中心-支付记录-请求开票。默认开具电子增值税普通发票，1000元以上可支持开具增值税专用发票。
官方文档：
http://api.kuaidi100.com/document/5f0ff8d42977d50a94e10238.html
http://api.kuaidi100.com/document/5f0ff8e32977d50a94e10239.html
