Short URL API 对接说明
内容提要
本文介绍Short URL API的对接方法：先在Ace Data Cloud控制台获取API Token，然后通过传递content字段将长URL转换为短URL，支持JSON格式响应。文中提供了CURL和Python示例代码，并说明了常见错误码及处理方法，帮助开发者快速集成该服务。
延伸解读
统一Token与免费额度
使用Short URL API前，需在Ace Data Cloud控制台获取API Token。该Token为平台通用，无需为每个服务单独申请，简化了多服务集成的认证流程。首次申请赠送免费额度，便于开发者无成本测试；额度不足时可在控制台充值通用余额，避免因欠费导致服务中断。
请求与响应格式
API采用POST请求，需在Headers中设置accept为application/json以获取JSON响应，authorization携带Bearer Token。请求体仅需传递content字段，即待缩短的长URL。响应包含success和data字段，data.url为生成的短链接。示例中长URL被转换为surl.id域名下的短链接，格式简洁。
错误码与排查建议
API返回常见错误码：400表示参数错误（如token_mismatched、api_not_implemented），401为无效Token，429为请求频率超限，500为服务器内部错误。错误响应包含error.code、message及trace_id，便于定位问题。开发者应检查Token有效性、参数格式及请求频率，必要时联系技术支持并提供trace_id。
Q&A
如何获取Short URL API的API Token？
首先到Ace Data Cloud控制台获取API Token。如果尚未登录或注册，会自动跳转到登录页面，完成注册和登录后会自动返回当前页面。一个API Token即可调用平台所有服务，无需为每个服务单独申请。首次申请会赠送免费额度。
Short URL API的基本使用方法是什么？
基本使用方法是向API发送POST请求，在请求体中传递content字段，其值为需要缩短的长URL。同时需要在请求头中设置accept为application/json（或其他期望格式），authorization为Bearer {token}。请求后返回JSON格式的响应，其中data.url为转换后的短URL。
Short URL API的请求参数有哪些？
主要参数包括：请求头中的accept（期望的响应格式，如application/json）、authorization（API密钥，格式为Bearer {token}）、content-type（设置为application/json）；请求体中的content（要缩短的URL）。
Short URL API返回结果中的字段含义是什么？
返回结果包含success字段，表示请求是否成功；data字段包含转换后的短URL，具体为data.url。例如：{"success": true, "data": {"url": "https://surl.id/1uHCs01xa5"}}。
Short URL API的常见错误码有哪些？
常见错误码包括：400 token_mismatched（参数缺失或无效）、400 api_not_implemented（接口未实现）、401 invalid_token（授权token无效或缺失）、429 too_many_requests（请求频率超限）、500 api_error（服务器内部错误）。
Short URL API的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/shorturl" } response = requests.post(url, json=payload, headers=headers) print(response.text) ```
Short URL API的CURL对接示例代码是什么？
示例代码如下： ```bash 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/shorturl"}' ```
