实用免费的 Short URL 短链接 API 对接说明
想必大家一定有把长链接转短链接的需求吧有没有免费好用的 API 呢有这里就是。本文将介绍一种 Short URL API 对接说明它可将较长的URL转换为短的URL。申请流程要使用 API需要先到 Short URL API https://platform.acedata.cloud/documents/shorturl 对应页面申请对应的服务进入页面之后点击「Acquire」按钮如图所示如果你尚未登录或注册会自动跳转到登录页面邀请您来注册和登录登录注册之后会自动返回当前页面。基本使用首先先了解下基本的使用方式就是输入需要转换的较长URL便可获得处理后的结果首先需要简单地传递一个content字段。我们接下来就可以在界面上填写对应的内容如图所示可以看到这里我们设置了 Request Headers包括accept想要接收怎样格式的响应结果这里填写为application/json即 JSON 格式。authorization调用 API 的密钥申请之后可以直接下拉选择。另外设置了 Request Body包括content要缩短的URL的内容。选择之后可以发现右侧也生成了对应代码如图所示点击「Try」按钮即可进行测试如上图所示这里我们就得到了如下结果{ success: true, data: { url: https://surl.id/1uHCs01xa5 } }返回结果一共有多个字段介绍如下success此处任务是否成功的状态。data包含了此处转换后的URL。可以看出 原先较长的URLhttps://platform.acedata.cloud/documents/a2303356-6672-4eb8-9778-75f55c998fe9?inviter_idb87f67c1-b04f-4332-99a1-7a5e651331c6?inviter_idb87f67c1-b04f-4332-99a1-7a5e651331c6?inviter_idb87f67c1-b04f-4332-99a1-7a5e651331c6已经成功转换为短的URLhttps://surl.id/1uHCs01xa5。另外如果想生成对应的对接代码可以直接复制生成例如 CURL 的代码如下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_idb87f67c1-b04f-4332-99a1-7a5e651331c6?inviter_idb87f67c1-b04f-4332-99a1-7a5e651331c6?inviter_idb87f67c1-b04f-4332-99a1-7a5e651331c6 }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_idb87f67c1-b04f-4332-99a1-7a5e651331c6?inviter_idb87f67c1-b04f-4332-99a1-7a5e651331c6?inviter_idb87f67c1-b04f-4332-99a1-7a5e651331c6 } response requests.post(url, jsonpayload, headersheaders) print(response.text)错误处理在调用 API 时如果遇到错误API 会返回相应的错误代码和信息。例如400 token_mismatchedBad request, possibly due to missing or invalid parameters.400 api_not_implementedBad request, possibly due to missing or invalid parameters.401 invalid_tokenUnauthorized, invalid or missing authorization token.429 too_many_requestsToo many requests, you have exceeded the rate limit.500 api_errorInternal server error, something went wrong on the server.错误响应示例{ success: false, error: { code: api_error, message: fetch failed }, trace_id: 2cf86e86-22a4-46e1-ac2f-032c0f2a4e89 }结论通过本文档您已经了解了如何使用 Short URL API 将较长的URL转换为短的URL。希望本文档能帮助您更好地对接和使用该 API。如有任何问题请随时联系我们的技术支持团队。