Logo

用户权限与 API 错误码

了解用户所需的不同类型权限,以及不同API错误代码的含义。

概念

用户权限与 API 错误码

了解用户所需的不同类型权限,以及不同API错误代码的含义。

用户权限

在应用授权步骤中,我们需要根据应用程序的具体使用场景向用户请求相应的权限。某些接口要求我们的应用具备特定权限才能返回所需响应。以下是可用权限的列表:

权限名称描述
basic_access包含用户名、名字和头像
email用户的电子邮件地址
offline_access应用可在任何时间访问用户数据
manage_library添加/重命名播放列表;调整播放列表中的歌曲顺序
manage_community添加或移除关注/粉丝关系
delete_library允许应用删除用户播放列表中的项目
listening_history允许应用访问用户的收听历史记录

API 错误码

如果向 Deezer 服务器发起的 API 请求因某种原因失败,Deezer API 会返回一些错误码。这些错误码有助于我们进行调试和问题排查。以下是常见的错误码及其对应的常量名:

错误码常量名
4QUOTA
100ITEMS_LIMIT_EXCEEDED
200PERMISSION
300TOKEN_INVALID
500PARAMETER
501PARAMETER_MISSING
600QUERY_INVALID
700SERVICE_BUSY
800DATA_NOT_FOUND
901INDIVIDUAL_ACCOUNT_NOT_ALLOWED

结论