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

2021-05-25 10:47:21 浏览数 (1)

一、快递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 请求参数示例

代码语言:txt复制
    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 返回数据示例

代码语言:txt复制
{
    "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 返回数据示例

代码语言:txt复制
{
    "status": 1,
    "data": {
        "outorder": "143255893",
        "message": "",
        "status": "发送成功"
    },
    "msg": "短信发送结果信息",
    "extra": "",
    "total": 0
}       

2.3 请求报文响应示例

代码语言:txt复制
{
    "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

0 人点赞