概述
灵驭安卓包名查询系统API提供了查询和访问应用数据库的功能。API的基础URL是 https://api.dmafx.work/api
请求限制
- 每分钟请求数: 60
- 每小时请求数: 1000
- 每日请求次数(普通用户: 500
- 每日请求次数(管理员: 1000
错误码说明
| 状态码 | 错误码 | 描述 |
|---|---|---|
| 400 | empty_query | 搜索关键词不能为空 |
| 401 | api_key_missing | API密钥未提供 |
| 401 | api_key_invalid | API密钥无效 |
| 403 | permission_denied | 权限不足 |
| 404 | app_not_found | 未找到应用 |
| 429 | api_limit_exceeded | API调用次数已达上限 |
认证方式
所有API请求都需要使用API密钥进行认证。您可以通过以下两种方式提供API密钥
1. 请求参数方式
GET /api/search?q=com.example.app&api_key=your_api_key_here
2. 请求头方式
X-API-Key: your_api_key_here
请保护好您的API密钥，不要在客户端代码中暴露它
基础接口
GET
/api/health
API健康检查，无需认证，用于探测服务是否可用
GET
/api/search
根据包名或应用名称搜索应用
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 是 | 搜索关键词 |
| exact | boolean | 否 | 精确匹配(默认:false) |
| limit | integer | 否 | 结果数量限制(默认:20) |
GET
/api/app/{package_name}
根据包名获取单个应用的详情
URL参数
| 参数 | 类型 | 说明 |
|---|---|---|
| package_name | string | 应用包名 |
GET
/api/apps
获取所有应用列表(分页)
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码(默认:1) |
| per_page | integer | 否 | 每页条数(默认:20) |
| category | string | 否 | 按类别筛选 |
GET
/api/categories
获取所有应用类别
POST
/api/clear_search_history
清除当前用户的所有搜索历史记录（需登录，无需请求体）