API常见问题
解答您在使用API过程中可能遇到的问题
账号与认证
如何获取API密钥？
登录您的账户后，进入"个人信息"页面，在API密钥管理区域点击"生成API密钥"按钮即可。生成的API密钥仅会显示一次，请妥善保管。
API密钥泄露了怎么办？
如果您怀疑API密钥已泄露，请立即登录账户，进入"个人信息"页面的API密钥管理区域，点击"重置API密钥"按钮生成新的密钥。旧密钥将在24小时内失效。
API密钥有有效期吗？
API密钥没有固定的有效期，但建议您定期更新以保障账户安全。您可以在"个人信息"页面的API密钥管理区域查看API密钥的生成时间和最后使用时间。
如何查看API调用记录和配额使用情况？
登录账户后，进入"个人信息"页面，您可以查看API调用记录和配额使用情况统计。我们提供了详细的API调用日志和用量图表，帮助您了解API的使用情况。
如何升级API调用配额？
您可以在账户的"会员中心"或"套餐管理"页面选择更高级的套餐，以获取更高的API调用配额。如有特殊需求，也可以联系我们的客服团队定制专属方案。
API使用
API支持哪些请求方式？
我们的API支持GET、POST、PUT、DELETE等常见的HTTP请求方式，具体每个接口支持的请求方式请参考对应的API文档。
API返回的数据格式是什么？
所有API接口均返回JSON格式的数据。我们建议在处理响应数据时，使用标准的JSON解析库进行解析。
如何处理API返回的错误码？
每个API接口都有详细的错误码说明，请参考API文档中的错误码部分。当API调用失败时，响应中会包含错误码和错误信息，您可以根据这些信息排查问题。
API有调用频率限制吗？
是的，为了保证服务的稳定性和公平使用，我们对API调用设置了频率限制。不同的套餐对应不同的调用频率限制，具体请参考API文档中的相关说明。
如何批量操作短链接或二维码？
我们提供了批量操作的API接口，您可以在API文档中查找"批量创建短链接"、"批量生成二维码"等相关接口。请注意，批量操作也受API调用频率和配额的限制。
短链接功能
生成的短链接有有效期吗？
默认情况下，生成的短链接是永久有效的。您也可以在创建短链接时设置过期时间，过期后短链接将无法访问或跳转到指定的过期页面。
短链接的点击数据如何统计？
我们会自动统计每个短链接的点击次数、来源IP、访问设备等信息。您可以通过API接口查询这些统计数据，也可以在用户后台查看详细的数据分析报告。
如何自定义短链接的后缀？
我们的高级套餐支持自定义短链接后缀功能。您可以在创建短链接时指定自定义的后缀，但需要确保该后缀未被其他用户使用。
短链接支持哪些类型的跳转？
我们支持标准的HTTP重定向跳转，以及针对微信等特定平台的优化跳转。您可以在创建短链接时选择适合的跳转类型。
如何设置短链接的访问密码？
我们的部分套餐支持短链接访问密码功能。您可以在创建短链接时设置访问密码，访问者需要输入正确的密码才能访问目标链接。
二维码功能
支持生成哪些类型的二维码？
我们支持生成标准二维码、彩色二维码、Logo二维码等多种类型。您可以根据需要选择不同的样式和参数。
生成的二维码图片有哪些格式可选？
我们支持生成PNG、JPG、SVG等常见的图片格式。其中SVG格式支持无损缩放，适合印刷和高清显示。
如何调整二维码的大小和纠错级别？
您可以在调用二维码生成API时，通过参数指定二维码的大小和纠错级别。纠错级别越高，二维码的容错能力越强，但同时也会导致二维码图案更复杂。
二维码可以包含哪些类型的内容？
二维码可以包含网址、文本、联系信息、Wi-Fi配置等多种类型的内容。您可以根据需要选择合适的内容类型。
如何统计二维码的扫描次数？
如果您将二维码与短链接结合使用，我们会自动统计二维码的扫描次数和相关数据。您可以通过API接口或用户后台查看这些统计信息。
故障排查
API调用返回401错误怎么办？
401错误通常表示认证失败。请检查您的API密钥是否正确，是否已过期，以及请求中的认证方式是否符合要求。如果问题仍然存在，请尝试重置API密钥。
API调用返回429错误怎么办？
429错误表示您的API调用频率超过了限制。请减少调用频率，或考虑升级套餐以获取更高的调用配额。我们建议实现请求重试机制，并在重试时使用指数退避策略。
短链接无法正常跳转怎么办？
请检查短链接是否已过期，目标网址是否可访问，以及您的网络连接是否正常。如果问题仍然存在，请联系我们的客服团队进行排查。
生成的二维码无法被扫描怎么办？
请检查二维码图片是否清晰，尺寸是否合适，以及纠错级别是否足够。如果问题仍然存在，请尝试调整二维码的参数重新生成。
API响应时间过长怎么办？
API响应时间可能受网络条件、服务器负载等多种因素影响。我们建议实现超时处理机制，并在遇到超时情况时进行重试。如果您经常遇到响应时间过长的问题，请联系我们的客服团队。