# OpenAPI

通过服务端访问千岛平台数据。以下链接均为对应接口的完整 Markdown 文档。

## 认证

OAuth 2.0 获取 / 刷新 Access Token

所有业务 API 请求需携带 access-token 请求头传入访问令牌，以及 x-echo-qdmp-version 版本标识。

- [获取访问令牌](https://open.qiandao.com/docs/api/auth-token.md)：POST /auth/v1/token
- [刷新令牌](https://open.qiandao.com/docs/api/auth-refresh.md)：POST /auth/v1/refresh

## 用户

获取当前授权用户信息

- [获取当前用户](https://open.qiandao.com/docs/api/user-me.md)：GET /user/v1/me

## 岛屿

获取岛详情

- [获取岛详情](https://open.qiandao.com/docs/api/island-detail.md)：GET /island/v1/detail

## 商品

查询和搜索商品信息

- [获取商品详情](https://open.qiandao.com/docs/api/spu-detail.md)：GET /spu/v1/detail
- [搜索商品](https://open.qiandao.com/docs/api/spu-search.md)：GET /spu/v1/search

## 标签

查询标签分类

- [获取标签详情](https://open.qiandao.com/docs/api/tag-detail.md)：GET /tag/v1/detail
- [搜索标签](https://open.qiandao.com/docs/api/tag-search.md)：GET /tag/v1/search

## 标记

管理用户的商品标记与评分

- [添加标记](https://open.qiandao.com/docs/api/mark-add.md)：POST /mark/v1/add
- [批量添加标记](https://open.qiandao.com/docs/api/mark-batch-add.md)：POST /mark/v1/batch/add
- [获取标记列表](https://open.qiandao.com/docs/api/mark-list.md)：GET /mark/v1/me/list
- [搜索标记](https://open.qiandao.com/docs/api/mark-search.md)：GET /mark/v1/me/search
- [标记详情](https://open.qiandao.com/docs/api/mark-detail.md)：GET /mark/v1/me/detail

## 想要

批量添加 / 取消想要，查询想要列表

- [批量添加想要](https://open.qiandao.com/docs/api/wish-add.md)：POST /wishspu/v1/add
- [批量取消想要](https://open.qiandao.com/docs/api/wish-cancel.md)：POST /wishspu/v1/cancel
- [获取想要列表](https://open.qiandao.com/docs/api/wish-list.md)：GET /wishspu/v1/list

## 社区发帖

获取发帖模板、发布和查询社区帖子

- [查询小程序帖子详情](https://open.qiandao.com/docs/api/post-detail.md)：GET /post/v1/detail
- [分页查询小程序帖子](https://open.qiandao.com/docs/api/post-list.md)：GET /post/v1/list
- [分页查询当前用户发布的公开帖子](https://open.qiandao.com/docs/api/post-my-list.md)：GET /post/v1/me/list

## 评论

发表、回复、点赞和查询帖子评论

- [发表评论](https://open.qiandao.com/docs/api/comment-create.md)：POST /comment
- [回复评论](https://open.qiandao.com/docs/api/comment-reply.md)：POST /comment/{commentId}/reply
- [评论 / 回复点赞](https://open.qiandao.com/docs/api/comment-like.md)：POST /comment/{commentId}/like
- [获取帖子评论](https://open.qiandao.com/docs/api/post-comments.md)：GET /post/{postId}/comments
- [获取评论回复](https://open.qiandao.com/docs/api/comment-replies.md)：GET /comment/{commentId}/replies

## GenAI

异步 AI 生成任务（TAMS Gateway）

- [创建生成任务](https://open.qiandao.com/docs/api/genai-generate.md)：POST /genai/v1/generate
- [查询任务状态](https://open.qiandao.com/docs/api/genai-detail.md)：GET /genai/v1/detail

网页：https://open.qiandao.com/docs/api