API文档

公开只读数据API，供AI Agent与RAG系统直接读取

快速开始

# 获取全部数据（展会 + 展商 + 服务商）
curl https://exposoon.com/api/public/dataset?type=all

# 仅获取展会数据
curl https://exposoon.com/api/public/dataset?type=exhibition

# 按行业过滤
curl "https://exposoon.com/api/public/dataset?type=exhibition&industry=电子"

API端点

方法	路径	说明
GET	/api/public/dataset?type=all	获取全部三类实体数据（展会 + 展商 + 服务商）
GET	/api/public/dataset?type=exhibition	获取全部展会数据
GET	/api/public/dataset?type=exhibitor	获取全部展商数据
GET	/api/public/dataset?type=service_provider	获取全部服务商数据
GET	/api/public/schema	获取 API 数据字典（自描述 schema）

查询参数

参数名	类型	默认值	说明
type	exhibition \| exhibitor \| service_provider \| all	all	数据类型，默认返回全部
q	string	—	按名称字段全文关键词搜索
industry	string	—	按行业过滤（如 ?industry=电子）
country	string	—	按国家过滤
city	string	—	按城市过滤
limit	number	100	返回条数（最大 500）
offset	number	0	分页偏移量

响应格式

exhibitions / exhibitors / service_providers：实体数组，按 type 返回对应数据
_links：每个实体含 self URL 与关联实体 URL
_rag_text：预拼接的语义文本，可直接用于 RAG 嵌入
_meta：schema 版本、字段描述、数量统计与分页信息

{
  "exhibitions": [ { "id": 1, "name_cn": "...", "name_en": "...", "_links": { "self": "...", "exhibitors": "...", "providers": "..." }, "_rag_text": "..." } ],
  "exhibitors":    [ { "id": 1, "company_cn": "...", "company_en": "...", "_links": { "self": "...", "exhibitions": ["..."] }, "_rag_text": "..." } ],
  "service_providers": [ { "id": 1, "name_cn": "...", "name_en": "...", "_links": { "self": "..." } } ],
  "_meta": {
    "type": "all",
    "schema_version": "1.0",
    "count": 123,
    "generated_at": "2026-01-01T00:00:00.000Z",
    "base_url": "https://exposoon.com",
    "entities": { "...": "auto-generated field schema" }
  }
}

数据结构

实体	关键字段
展会	id, name_cn, name_en, industry_tags_cn, industry_tags_en, country, city, start_date, end_date, status, organizer, venue, official_url
参展商	id, company_cn, company_en, industry_tags, product_tags, intro, exhibit_history, tags, weight, official_url
服务商	id, name_cn, name_en, service_types, cover_regions, good_at_industry, intro, case_images, is_verified

完整字段说明见 GET /api/public/schema 返回的 _meta.entities（自动生成的数据字典）。

使用示例

# 获取即将举办的展会
curl "https://exposoon.com/api/public/dataset?type=exhibition&q=upcoming"

# 按行业搜索展会
curl "https://exposoon.com/api/public/dataset?type=exhibition&industry=电子"

# 分页获取展商
curl "https://exposoon.com/api/public/dataset?type=exhibitor&limit=50&offset=0"

# 获取 API 数据字典
curl https://exposoon.com/api/public/schema

速率限制

Cache-Control: public, max-age=300（5 分钟缓存）。公开数据每 5 分钟刷新一次，建议客户端遵循缓存头以减少重复请求。无需鉴权，可直接被 AI Agent 与 RAG 系统读取。