mirror of
https://github.com/alibaba/higress.git
synced 2026-04-22 12:37:26 +08:00
49 lines
3.3 KiB
Markdown
49 lines
3.3 KiB
Markdown
# 图书查询
|
||
|
||
API认证需要的APP Code请在阿里云API市场申请: https://market.aliyun.com/apimarket/detail/cmapi00066353
|
||
|
||
## 什么是云市场API MCP服务
|
||
|
||
阿里云云市场是生态伙伴的交易服务平台，我们致力于为合作伙伴提供覆盖上云、商业化和售卖的全链路服务，帮助客户高效获取、部署和管理优质生态产品。云市场的API服务涵盖以下几个类目：应用开发、身份验证与金融、车辆交通与物流、企业服务、短信与运营商、AI应用与OCR、生活服务。
|
||
云市场API依托Higress提供MCP服务，您只需在云市场完成订阅并获取AppCode，通过Higress MCP Server进行配置，即可无缝集成云市场API服务。
|
||
|
||
## 如何在使用云市场API MCP服务
|
||
|
||
1. 进入API详情页，订阅该API。您可以优先使用免费试用。
|
||
2. 前往云市场用户控制台，使用阿里云账号登陆后查看已订阅API服务的AppCode，并配置到Higress MCP Server的配置中。注意：在阿里云市场订阅API服务后，您将获得AppCode。对于您订阅的所有API服务，此AppCode是相同的，您只需使用这一个AppCode即可访问所有已订阅的API服务。
|
||
3. 云市场用户控制台会实时展示已订阅的预付费API服务的可用额度，如您免费试用额度已用完，您可以选择重新订阅。
|
||
|
||
## 功能简介
|
||
|
||
主要用于通过ISBN书号来查询图书的详细信息。该服务接收一个包含ISBN书号的请求，并向外部API发送请求以获取与该ISBN相关的所有可用数据，包括但不限于作者、出版日期、出版社等信息。此功能对于图书馆管理系统、在线书店以及其他需要根据ISBN快速查找书籍详情的应用非常有用。
|
||
|
||
## 工具简介
|
||
|
||
### ISBN书号查询
|
||
- **用途**：此工具允许用户输入ISBN书号并获取关于该书号所对应书籍的全面信息。
|
||
- **使用场景**：
|
||
- 当开发者或系统集成者需要为用户提供基于ISBN的书籍检索功能时。
|
||
- 对于那些希望通过ISBN快速了解一本书籍的所有相关信息（如作者、版本、价格等）的情况。
|
||
- 在构建涉及大量书籍管理或者销售的平台时作为基础的数据查询手段之一。
|
||
|
||
#### 参数说明
|
||
- `isbn`: 用户必须提供的ISBN书号，类型为字符串。这是查询过程中唯一必需的信息点，用于定位特定的图书记录。
|
||
|
||
#### 请求示例
|
||
- **URL**: https://lhisbnshcx.market.alicloudapi.com/isbn/query
|
||
- **方法**: POST
|
||
- **头部信息**:
|
||
- Content-Type: application/x-www-form-urlencoded
|
||
- Authorization: 使用APP CODE进行身份验证
|
||
- X-Ca-Nonce: 生成的随机UUID值，确保每次请求的独特性
|
||
|
||
#### 响应结构
|
||
响应将以JSON格式返回，并包含以下主要字段：
|
||
- `code`: 接口返回的状态码，不同于HTTP状态码。
|
||
- `data`: 包含具体图书信息的对象。
|
||
- `details[]`: 图书的具体细节数组，每个元素代表一条记录，其中包括了诸如作者、标题、出版社等多种属性。
|
||
- `msg`: 返回的状态码对应的描述信息。
|
||
- `taskNo`: 任务订单号，可用于后续的服务商复核。
|
||
|
||
以上是针对YAML配置文件中提到的MCP服务器及其组件的一个简要概述。通过这些工具和服务，可以有效地实现对图书信息的查询和管理。
|