我要接入自己的程序
程序从公开目录取得接口编号和参数，再通过统一执行地址发起调用。
POST /api/v1/interfaces/{id}/execute同一个问题，可以用两种方式完成。
需要接入自己的程序就用 REST；希望 AI 自己找接口和填写参数就用 MCP。两种方式共用同一套目录、账户、价格和调用记录。
01
你准备怎么使用？
我要交给 AI 助手
AI 可以根据你的需求搜索目录、查看参数和价格，再调用当前开放接口。
POST /mcp02
AI 最常用的三个动作
你只需要说明要找什么；AI 按下面的顺序完成接口选择和调用。
search_data_interfaces1. 找到合适的接口
按平台、数据类型或日常关键词搜索当前公开目录。
get_data_interface_schema2. 确认需要填写什么
读取必填项、可选项、参数类型和成功调用价格。
call_data_interface3. 发起真实查询
按接口编号提交参数；成功结果进入账户的调用和费用记录。
get_account_usage需要时查看账户额度
查询当前余额和正在处理中的冻结金额，这个动作不发起数据调用。
03
程序调用也是同一条路径
REST 不需要理解 MCP 工具名，但仍然遵循“找接口 → 看参数 → 调用”的顺序。
浏览或搜索当前目录
当前共有 22 个平台、319 项已验收接口。
GET /api/v1/catalog/endpoints查看接口填写要求
接口详情页和目录响应会给出参数、当前正式价格与输出边界。
进入接口目录 →提交接口编号和参数
使用 Bearer API 令牌；网络重试时提供 Idempotency-Key，避免重复处理。
POST /api/v1/interfaces/{id}/execute04
调用成功后会得到什么
查询编号与状态
request_id 用于在工作台查看同一次查询和后续记录。
接口自己的数据
summary、data 和 meta 保留当前接口实际提供的数据结构并完成安全过滤。
本次费用记录
usage 记录正式价格和实际扣减；失败、超时或无有效结果不扣费。
05
连接前准备一枚 API 令牌
工作台、REST 和 MCP 使用同一个数桥账户
在工作台创建 API 令牌。完整令牌只显示一次，不要写进公开仓库、截图或聊天记录；怀疑泄露时立即停用。
如果不熟悉配置，可以对可信的 AI 说：“请保留我现有的 MCP 配置，添加数桥 Remote MCP 地址和 Bearer API 令牌。连接后先用 search_data_interfaces 搜索目录，不要显示完整令牌。”
06
需要浏览完整目录时
按领域、平台和能力逐层查看适合人工浏览；它不是完成一次查询的必经步骤。
list_data_domains查看数据领域
销售数据、社媒数据和全网搜索与研究。
list_data_platforms查看领域下的平台
返回平台及其当前公开接口数。
list_platform_capabilities查看平台能做什么
按商品、内容、评论、账号等用途分组。
list_capability_interfaces查看具体接口
返回接口编号、状态、价格和翻页信息。