电商快递物流信息短信通知API案例代码-快递100

一、快递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应用场景

1. 企业寄件或者电商发货后，通过短信的方式通知收件人已经发货；

2. 根据物流轨迹状态，可告知收件人物品在途情况，提醒收件人及时签收；

3. 可向顾客发送营销短信、活动推广短信等，推广产品和提高品牌形象。

三、短信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