> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# EDINET 文档下载

> 通过 AIsa 按 docID 下载 EDINET 申报文档。



## OpenAPI

````yaml openapi/zh/edinet.json GET /edinet/documents/{docID}
openapi: 3.1.0
info:
  title: EDINET API
  version: draft-2026-07-28
  description: 用于 EDINET 文档列表和文档下载的 AIsa 网关 endpoint。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /edinet/documents/{docID}:
    get:
      tags:
        - EDINET
      summary: 下载 EDINET 文档
      description: >-
        按 docID 下载指定的 EDINET 文档。返回的文件类型由 type 查询参数选择，实际成功响应的内容需根据 Content-Type
        解析。
      operationId: getEdinetDocumentDownload
      parameters:
        - name: docID
          in: path
          required: true
          schema:
            type: string
            examples:
              - S1000000
          description: 来自文档列表 API 的文档管理标识符。
        - name: type
          in: query
          required: true
          schema:
            type: integer
            enum:
              - 1
              - 2
              - 3
              - 4
              - 5
          description: >-
            要下载的文件类型：1 为申报正文和审计报告 ZIP，2 为 PDF，3 为替代文档及附件 ZIP，4 为英文文档 ZIP，5 为由
            XBRL 转换的 CSV ZIP。
      responses:
        '200':
          description: 根据 Content-Type，返回二进制 ZIP/PDF 文件内容或 JSON 错误载荷。
          content:
            application/octet-stream:
              schema:
                type: string
                format: binary
            application/pdf:
              schema:
                type: string
                format: binary
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
        '400':
          description: 请求参数无效。
        '401':
          description: AIsa API 密钥无效或缺失。
        '404':
          description: 未找到文档。
        '429':
          description: 超出速率限制。
        '500':
          description: 网关或上游故障。
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````