概念
用户权限与 API 错误码
了解用户所需的不同类型权限,以及不同API错误代码的含义。
用户权限
在应用授权步骤中,我们需要根据应用程序的具体使用场景向用户请求相应的权限。某些接口要求我们的应用具备特定权限才能返回所需响应。以下是可用权限的列表:
| 权限名称 | 描述 |
|---|---|
| basic_access | 包含用户名、名字和头像 |
| 用户的电子邮件地址 | |
| offline_access | 应用可在任何时间访问用户数据 |
| manage_library | 添加/重命名播放列表;调整播放列表中的歌曲顺序 |
| manage_community | 添加或移除关注/粉丝关系 |
| delete_library | 允许应用删除用户播放列表中的项目 |
| listening_history | 允许应用访问用户的收听历史记录 |
API 错误码
如果向 Deezer 服务器发起的 API 请求因某种原因失败,Deezer API 会返回一些错误码。这些错误码有助于我们进行调试和问题排查。以下是常见的错误码及其对应的常量名:
| 错误码 | 常量名 |
|---|---|
| 4 | QUOTA |
| 100 | ITEMS_LIMIT_EXCEEDED |
| 200 | PERMISSION |
| 300 | TOKEN_INVALID |
| 500 | PARAMETER |
| 501 | PARAMETER_MISSING |
| 600 | QUERY_INVALID |
| 700 | SERVICE_BUSY |
| 800 | DATA_NOT_FOUND |
| 901 | INDIVIDUAL_ACCOUNT_NOT_ALLOWED |