调用AddShortUrl创建短链,一天(自然日)最多可以创建5000个短链。

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

该接口仅针对部分用户开放,您需要向客服提供原始链接的主域名和客户UID信息,由阿里云将这些信息加入白名单。

调试

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

请求参数

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

系统规定参数,取值:AddShortUrl

EffectiveDays String 7

短链服务使用有效期,以天为单位,不超过30天。

ShortUrlName String 阿里短链测试

短链服务名称,不超过12个字符长度。

SourceUrl String https://www.****.com/product/sms

原始链接地址,不超过1000个字符长度。

返回数据

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

请求状态码。

Data Struct

短链详情。

ExpireDate String 2022-09-19 11:21:11

短链服务使用失效时间。

ShortUrl String http://****.cn/6y8uy7

生成的短链服务地址。

SourceUrl String https://www.****.com/product/sms

原始链接地址,不超过1000个字符长度。

Message String OK

状态码的描述。

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

请求ID。

示例

请求示例

http(s)://dysmsapi.aliyuncs.com/?Action=AddShortUrl
&SourceUrl=https://www.****.com/product/sms
&ShortUrlName=阿里短链测试
&EffectiveDate=7
&<公共请求参数>

正常返回示例

XML 格式

<AddShortUrlResponse>
  <Message>OK</Message>
  <RequestId>819BE656-D2E0-4858-8B21-B2E477085AAF</RequestId>
  <Data>
        <SourceUrl>https://www.****.com/product/sms</SourceUrl>
        <ShortUrl>http://****.cn/6y8uy7</ShortUrl>
        <ExpireDate>2022-09-19 11:21:11</ExpireDate>
  </Data>
  <Code>OK</Code>
</AddShortUrlResponse>

JSON 格式

{
    "Message": "OK",
    "RequestId": "819BE656-D2E0-4858-8B21-B2E477085AAF",
    "Data": {
        "SourceUrl": "https://www.****.com/product/sms",
        "ShortUrl": "http://****.cn/6y8uy7",
        "ExpireDate": "2022-09-19 11:21:11"
    },
    "Code": "OK"
}

错误码

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

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