调用CreateShortParam生成短参。支持通过接口针对每个手机号生成唯一用户标识ID,传入到短链中查看最终手机号点击信息。

短链:阿里短链服务可以快速将客户的原始长网址压缩成短网址,为客户预留更多的短信内容空间,支持标准API接口开放。

短参:支持将11位用户手机号转化为6位短参,拼接短链后形成基于手机号的短链,实现追踪到用户手机号维度的访问数据采集功能。

  • 您调用短链、短参生成相应的数据后,需按照拼接规则:ShortUrl?ph=ShortParam,形成带短参的新短链地址。
  • 您将新短链地址加入下发的短信内容中,下发至目标用户手机上,要注意保障每条短链上携带的短参与实际下发的手机号一致,才能保证采集到的数据准确性。
  • 若目标用户打开新短链地址,则阿里侧会生成一条日志信息,若没有打开则不生成日志信息。
  • 阿里侧导出您的目标用户日志信息,走数据披露流程,对外线下提供给您,时间周期一般为T+1。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateShortParam

系统规定参数。取值:CreateShortParam

PhoneNumbers String 15900195***

接收短信的手机号码。

国内短信:11位手机号码。例如:159595876***。

支持对多个手机号码发送短信,手机号码之间以英文逗号(,)分隔。单次调用上限为50000个手机号码。批量调用相对于单条调用及时性稍有延迟。

返回数据

名称 类型 示例值 描述
Code String OK

请求状态码。

Data Struct

短参详情。

ParamDetail String [{\"param\":\"15951955195\",\"sparam\":\"iZS1QU\"}, {\"param\":\"15951955196\",\"sparam\":\"iZS1QC\"}]

号码和短参的对应关系。

param为手机号,sparam为短参。

PhoneNumbers String 15951955195,15951955196

手机号码。

ShortParam String iZS1QU,iZS1QC

对应手机号生成的短参。PhoneNumbers与ShortParam的返回顺序一一对应。

Message String OK

状态码的描述。

RequestId String 819BE656-D2E0-4858-8B21-B2E477085AAF

请求ID。

示例

请求示例

http(s)://dysmsapi.aliyuncs.com/?Action=CreateShortParam
PhoneNumbers=15900195***
&<公共请求参数>

正常返回示例

XML 格式

<CreateShortParamResponse>
  <Message>OK</Message>
  <RequestId>819BE656-D2E0-4858-8B21-B2E477085AAF</RequestId>
  <Data>
        <ParamDetail>[{\"param\":\"15950195***\",\"sparam\":\"iZS1QU\"}, {\"param\":\"15950196***\",\"sparam\":\"iZS1QC\"}]</ParamDetail>
        <PhoneNumbers>15950195***,15950196***</PhoneNumbers>
        <ShortParam>iZS1QU,iZS1QC</ShortParam>
  </Data>
  <Code>OK</Code>
</CreateShortParamResponse>

JSON 格式

{
    "CreateShortParamResponse": {
        "Message": "OK",
        "RequestId": "819BE656-D2E0-4858-8B21-B2E477085AAF",
        "Data": {
            "ParamDetail": "[{\\\"param\\\":\\\"15950195***\\\",\\\"sparam\\\":\\\"iZS1QU\\\"}, {\\\"param\\\":\\\"15950196***\\\",\\\"sparam\\\":\\\"iZS1QC\\\"}]",
            "PhoneNumbers": "15950195***,15950196***",
            "ShortParam": "iZS1QU,iZS1QC"
        },
        "Code": "OK"
    }
}

错误码

HttpCode 错误码 错误信息 描述
400 ForbiddenAction Access to the account is denied. Please contact the administrator. 没有访问权限,请联系管理员

访问错误中心查看更多错误码。