1. API 错误代码

TPWallet 的 API 采用标准的 HTTP 状态码来表示错误类型。以下是常见的 API 错误代码及其详细说明。

1.1. 身份验证错误

状态码 错误代码 错误信息 说明 解决方案

401 AUTH001 身份验证失败 API 密钥无效或未提供 确认您使用的 API 密钥正确无误，并已包含在请求头中。

403 AUTH002 无访问权限 您的账户没有执行此操作的权限 检查 API 密钥的权限设置，确保拥有所需的权限。

1.2. 请求参数错误

状态码 错误代码 错误信息 说明 解决方案

400 PARAM001 缺少必需的请求参数 请求中缺少必要的参数 检查 API 文档，确保所有必需参数均已包含在请求中。

400 PARAM002 请求参数格式错误 提供的参数格式不符合要求 验证参数格式（如 JSON 结构、数据类型等）是否正确。

1.3. 速率限制错误

状态码 错误代码 错误信息 说明 解决方案

429 RATE001 请求过于频繁，请稍后重试 超过 API 速率限制 等待一段时间后重试，或优化请求频率。

1.4. 资源未找到

状态码 错误代码 错误信息 说明 解决方案

404 NOTFOUND001 请求的资源不存在 请求的 API 端点或资源不存在 检查 URL 是否正确，确保资源存在。

1.5. 服务器错误

状态码 错误代码 错误信息 说明 解决方案

500 SERVER001 内部服务器错误 TPWallet 服务器内部发生错误 尝试稍后重试，或联系 TPWallet 技术支持。

503 SERVER002 服务不可用 服务器正在维护或过载 等待服务恢复后再尝试请求。

2. 应用程序错误代码

TPWallet 应用程序在使用过程中也可能会遇到各种错误。以下是常见的应用程序错误代码及其解决方案。

2.1. 登录与身份验证错误

错误代码 错误信息 说明 解决方案

LOGIN001 登录失败：用户名或密码错误 用户名或密码输入不正确 检查用户名和密码是否正确，尝试重置密码。

LOGIN002 登录失败：账户被锁定 账户因多次失败尝试而被锁定 等待一段时间后重试，或联系 TPWallet 客服。

2.2. 交易失败

错误代码 错误信息 说明 解决方案

TXN001 交易失败：余额不足 账户余额不足以完成交易 检查账户余额，确保有足够的资金进行交易。

TXN002 交易失败：网络错误 交易过程中发生网络问题 检查网络连接，稍后重试交易。

TXN003 交易失败：地址无效 提供的接收地址格式不正确或不存在 验证接收地址是否正确，确保地址有效。

2.3. 同步与连接错误

错误代码 错误信息 说明 解决方案

SYNC001 同步失败：无法连接到服务器 应用无法连接到 TPWallet 服务器 检查网络连接，确保设备可以访问互联网。

SYNC002 同步失败：服务器响应超时 服务器响应时间过长 等待一段时间后重试，或检查是否有服务器维护通知。

3. 智能合约错误代码

在使用 TPWallet 进行智能合约交互时，可能会遇到以下错误。

3.1. 合约执行失败

错误代码 错误信息 说明 解决方案

SC001 合约执行失败：函数不存在 调用的合约函数在合约中未定义 检查函数名称和参数是否正确，确认合约版本。

SC002 合约执行失败：权限不足 调用的合约函数需要更高权限 确保调用者拥有执行该函数所需的权限。

3.2. 权限不足

错误代码 错误信息 说明 解决方案

SC003 权限错误：未授权的操作 当前用户未被授权执行此操作 检查用户权限设置，确保拥有必要的权限。

SC004 权限错误：智能合约调用被拒绝 智能合约拒绝当前的调用请求 联系合约管理员，了解权限要求和获取授权。

4. 常见问题与解决方案

4.1. 为什么会遇到身份验证错误？

原因：API 密钥错误、未包含在请求头中，或 API 密钥权限不足。

解决方案：确认 API 密钥的正确性，确保已正确设置请求头，并检查 API 密钥的权限设置。

4.2. 如何处理速率限制错误？

原因：在短时间内发送了过多的 API 请求，超过了速率限制。

解决方案：

等待重试：根据错误响应中的 Retry-After 时间等待后再重试。

优化请求频率：减少不必要的 API 调用，使用缓存策略。

申请提升速率限制：联系 TPWallet 技术支持，申请更高的速率限制。

4.3. 交易失败时如何诊断问题？

步骤：

检查错误代码与信息：根据错误代码定位问题类型。

验证账户余额：确保账户有足够的资金。

确认接收地址：检查地址是否正确且有效。

查看网络状态：确保网络连接稳定。

联系支持团队：如果问题无法解决，联系 TPWallet 客服获取帮助。

5. 错误处理最佳实践

详细记录错误：

在应用程序中记录所有错误代码和相关信息，便于后续分析和解决。

实施重试机制：

对于可恢复的错误（如网络问题、速率限制），实现自动重试机制，提升系统的可靠性。

用户友好的错误提示：

向用户展示清晰、易懂的错误信息，指导用户如何解决问题，而非仅显示技术性错误代码。

安全处理敏感信息：

确保错误日志中不包含敏感的用户数据或 API 密钥，保护用户隐私和系统安全。

定期审查与优化：

定期审查错误日志，分析常见问题，优化代码和系统架构，减少错误发生率。