短网址 API 集成指南

本文将介绍如何使用短网址 API，将长网址转换为短网址。短网址服务可以帮助用户简化链接，便于分享和传播，广泛应用于社交媒体、电子邮件营销等场景。

环境准备

在使用短网址 API 之前，您需要先在 Short URL API 页面申请相应的服务。首次申请会授予您一个免费的配额，允许您免费使用 API。

详细步骤

申请服务

访问 Short URL API 页面。
点击"获取"按钮，如下图所示：

如果您未登录或未注册，将自动跳转到登录页面。请注册或登录后返回当前页面。

基本使用

在了解了申请流程后，下面是如何使用短网址 API 的基本方法：

准备需要转换的长网址。在接口中，您需要传入一个 content 字段。如下图所示：

设置请求头，包括：
accept: 您希望接收的响应结果格式，填写为 application/json，表示返回 JSON 格式。
authorization: 调用 API 的密钥，可以在申请后直接选择。
设置请求体，包括：
content: 需要缩短的网址内容。
在右侧可以看到生成的相应代码，如下图：

点击"尝试"按钮进行测试，您将收到如下结果：

json { "success": true, "data": { "url": "https://surl.id/1uHCs01xa5" } }

返回的结果包含多个字段，具体说明如下： - success: 任务是否成功的状态。 - data: 包含转换后的 URL。

您可以看到，原始长网址 https://platform.acedata.cloud/documents/a2303356-6672-4eb8-9778-75f55c998fe9?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7 已成功转换为短网址 https://surl.id/1uHCs01xa5。

生成集成代码

如果您想生成相应的集成代码，可以直接复制，以下是 CURL 示例代码：

shell 复制代码

curl -X POST 'https://api.acedata.cloud/shorturl' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "content": "https://platform.acedata.cloud/documents/a2303356-6672-4eb8-9778-75f55c998fe9?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7"
}'

以下是 Python 集成代码示例：

python 复制代码

import requests

url = "https://api.acedata.cloud/shorturl"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "content": "https://platform.acedata.cloud/documents/a2303356-6672-4eb8-9778-75f55c998fe9?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7?inviter_id=7d4e4015-79b6-4aba-a566-441f706481a7"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

错误处理

在调用 API 时，如果发生错误，API 将返回相应的错误代码和信息，例如：

400 token_mismatched: 错误请求，可能是由于参数缺失或无效。
401 invalid_token: 未授权，授权令牌无效或缺失。
429 too_many_requests: 请求过多，超过了速率限制。
500 api_error: 服务器内部错误。

错误响应示例

json 复制代码

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

总结

通过本文，您已经学习了如何使用短网址 API 将长网址转换为短网址。希望本文能够帮助您更好地集成和使用该 API。如果您有任何问题，请随时联系我们的技术支持团队。

链接推荐 ： - Ace Data Cloud - API 文档 - Dify 主页

技术标签：#短网址 #API集成 #Python #JSON #开发教程