创蓝vip接口文件2016新版1582、http-短信

1、接口说明公司：400-6818-253目录1普通发送4提交地址4参数定义4提交响应.21.3.3格式说明5示例5响应状态值说明61.41.5状态212.22.3注意事项7发送例子7推送11参数定义122状态值12示例123接收13参数定义13示例133.13.24额度查询接口4.445接口地址14参数定义14提交响应14提交响应值14示例15本文档主要定了对用户开放的主要接口和定义。1普通发送用户可通过 HTTP 的 GET 和T 方式提交发送请求。1.1提交地址可以提交不超过 50000 个号码，每个号码用英文逗号间隔。URL 地址为

2、：。注：其中 IP:PORT 为服务部署的地址和端口。行业帐号 IP 为 58，PORT 默认为 80.帐号 IP 为 69，PORT 默认为 80.1.2参数定义序号参数说明1account必填参数。用户账号2pswd必填参数。用户3mobile必填参数。合法机号码，号码间用英文逗号分隔4msg必填参数。 内容， 内容长度 过 585 个字符。使用 URL 方式编码为 UTF-8 格式。 内容超过 70 个字符（企信通是 60 个字符）时，会被拆分成多条，然后以长 的格式发送。5needsus必填参数。是否需要状态，取值 true 或false， true，表明需要状态；false 不需要状

3、态6extno可选参数，扩展码，用户定义扩展码，3 位1.3提交响应用户通过 http 请求提交到服务器后，服务器返回响应码，响应码的格式如下：1.3.1格式说明提交响应分为两行，第一行为响应时间和状态，第二行为服务器给出提交 msgid。无论发送的号码是多少，一个发送请求只返回一个 msgid，如果响应的状态不是“0”，则没有 msgid 即第二行数据。（每行以换行符(0 x0a,即n)分割）1.3.2示例提交成功响应时间为 20110725160412，响应状态为 0 表明那个成功提交到服务器；1234567890100 为返回的 msgid，这个工状态匹配时使用。提交失败20110725

4、160412,10120110725160412,01234567890100resptime,respsusmsgid本示例表明用户提交失败，返回错误码为 101，服务器端并未返回 msgid。1.3.3响应状态值说明1.4注意事项用户如果有审核的限制，则客户的必须经过代码说明0提交成功101无此用户102错103提交过快（提交速度超过流速限制）104系统忙（因侧原因，暂时无法处理提交的）105敏感（内容包含）106消息长度错（536 或50000 或200 或创蓝服务器-运营商-客户终端（成功或者失败状态）：运营商-创蓝服务器-接收地址：例如：客户服务器发送服务器在收到状态后需要自己写个方

5、法去做处理收到的参数。3接收3.1参数定义3.2示例普通：序号参数说明1receiver接收信息验证的用户名（不是账户名），是按照用户要求配置的名称，可以为空2pswd接收信息服务需验证的，可以为空3moTime格式 YYMMDDhhmm，其中 YY=年份的最后两位（00-99）， MM=月份（01-12），DD=日（01-31），hh=小时（00-23）， mm=分钟（00-59）4mobile单一机号码5msgMO内容，文字内容使用 UTF-8 编码6destcode用户上行的目的号码7isems是否为长的一部分，1:是，0，不是。不带该参数，默认为普通8emsheadIsems 为 1

6、时，本参数以 ASCII 码形式显示长的头信息。用“,”隔开，分为三个部分，第一部分标识该条长的 ID（该 ID 为中心生成）；第二部分，表明该长的总条数（pk_total）；第三部分，该条为该长的第几条(pk_number)。例如：234,4,1，该的 ID 为 234,该长的总长度为 4 条，1，当前为第一条。obile=&msg=o&destcode=10657109012345其中，pushUrl 为用户启动的服务地址。说明：需要的服务器起一个 http 服务，和服务器的IP 地址组成一个接收地址，能够让创蓝的服务器到客户的服务器。状态实现原理：客户通过 10690 的接入号编辑发送短信内容，如编辑：你好到 10690554645656- 运营商 - 创蓝服务器 - 接收地址：例如： 客户服务器发送服务器在收到上行后需要自己写个方法去做处理收到的参数。4额度查询接口4.1接口地址注：其中 IP:PORT 为服务部署的地址和端口。行业帐号 IP 为 58，PORT 默认为 80.帐号 IP 为 69，PORT 默认为 80.4.2参数定义序号参数说明1account必填参数。用户账号2pswd必填参数。用户4.3提交响应第一行显示返回额度时的时间，提交响应值。第二行开始，每一行显示一个产品 ID 及