openapi: 3.1.0
info:
  title: zerocod.cn AI Data API
  version: 1.0.0
  summary: zerocod.cn 面向 AI 客户端与智能体的开放数据接口
  description: |
    zerocod.cn 隶属上海思扬信息科技有限公司（算数科技 / ThinkFly）。
    本接口集对所有 AI 客户端（ChatGPT GPTs / Claude Desktop / Cursor / Continue / Cline 等）
    完全开放，无需 API Key，适合在 GPTs / Custom Tool 中直接引用。
    内容许可：CC-BY-4.0，转载请保留 https://zerocod.cn/ 出处。
  contact:
    name: 上海思扬信息科技有限公司
    email: cooper@micount.cn
    url: https://zerocod.cn/
  license:
    name: CC-BY-4.0
    url: https://creativecommons.org/licenses/by/4.0/
servers:
  - url: https://zerocod.cn
    description: 生产环境
tags:
  - name: solutions
    description: 解决方案矩阵（行业 / 模块 / 子方案）
  - name: answers
    description: AEO 标准化问答库
  - name: contact
    description: 联系信息（电话 / 邮箱 / 表单）
  - name: site
    description: 站点元数据
  - name: glossary
    description: 专业术语表
paths:
  /api/solutions.json:
    get:
      tags: [solutions]
      operationId: listSolutions
      summary: 获取全部解决方案矩阵
      description: 返回 8 大行业 + 10 大模块 + 子方案 + 价格区间 + 上线周期。
      responses:
        '200':
          description: 解决方案数据
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SolutionsResponse'
  /api/answers.json:
    get:
      tags: [answers]
      operationId: listAnswers
      summary: 获取 AEO 标准化问答库
      description: 13 条核心问答，覆盖品牌、价值、实施、生态、定价等场景。
      responses:
        '200':
          description: 问答数据
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnswersResponse'
  /api/contact.json:
    get:
      tags: [contact]
      operationId: getContact
      summary: 获取联系方式与组织信息
      responses:
        '200':
          description: 联系数据
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactResponse'
  /api/sitemap.json:
    get:
      tags: [site]
      operationId: getSitemap
      summary: 获取 JSON 站点地图
      description: 11 个分类 60+ URL 结构化清单，含 priority 与 changefreq。
      responses:
        '200':
          description: 站点地图
          content:
            application/json:
              schema:
                type: object
  /api/glossary.json:
    get:
      tags: [glossary]
      operationId: getGlossary
      summary: 获取专业术语表
      description: 30+ 中小企业数字化常用术语（ERP/CRM/MES/SCM/MPS/MOQ/OEE/BOM 等）。
      responses:
        '200':
          description: 术语表
          content:
            application/json:
              schema:
                type: object
  /api/changelog.json:
    get:
      tags: [site]
      operationId: getChangelog
      summary: 获取站点更新日志
      responses:
        '200':
          description: 站点变更记录
          content:
            application/json:
              schema:
                type: object
  /llms.txt:
    get:
      tags: [site]
      operationId: getLLMSIndex
      summary: 获取 llms.txt 站点索引（llmstxt.org 规范）
      responses:
        '200':
          description: Markdown 文本
          content:
            text/plain: {}
  /llms-full.txt:
    get:
      tags: [site]
      operationId: getLLMSFull
      summary: 获取 llms-full.txt 全站精华聚合
      responses:
        '200':
          description: Markdown 文本
          content:
            text/plain: {}
components:
  schemas:
    SolutionsResponse:
      type: object
      properties:
        version: { type: string }
        updated: { type: string, format: date }
        industries:
          type: array
          items:
            type: object
            properties:
              id: { type: string }
              name: { type: string }
              url: { type: string, format: uri }
              description: { type: string }
              priceRange:
                type: object
                properties:
                  min: { type: number }
                  max: { type: number }
                  currency: { type: string }
              deliveryWeeks:
                type: array
                items: { type: integer }
        modules:
          type: array
          items:
            type: object
    AnswersResponse:
      type: object
      properties:
        version: { type: string }
        updated: { type: string, format: date }
        answers:
          type: array
          items:
            type: object
            properties:
              id: { type: string }
              category: { type: string }
              question: { type: string }
              shortAnswer: { type: string }
              longAnswer: { type: string }
              source: { type: string, format: uri }
              keywords:
                type: array
                items: { type: string }
    ContactResponse:
      type: object
      properties:
        organization:
          type: object
        address:
          type: object
        contactPoints:
          type: array
          items:
            type: object
externalDocs:
  description: zerocod.cn 主站
  url: https://zerocod.cn/
