CN Evidence Free API

openapi: 3.2.0
info:
  title: Cnevidence Com Free API
  version: 2.0.0
  description: 'Operations tagged Free across 2 of this provider''s published API definitions: cnevidence-com-openapi.json, cnevidence-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.cnevidence.com
tags:
- name: Free
paths:
  /free/cn/identity/preflight:
    post:
      operationId: preflight_china_supplier_input
      summary: Free input-format preparation, not entity resolution
      description: No upstream request or payment. input_ready never implies verified identity. No USCC checksum check.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                company:
                  type: string
                uscc:
                  type: string
      responses:
        '200':
          description: Local format guidance and request examples; inspect input_ready and errors
        '422':
          description: Malformed JSON
      tags:
      - Free
    servers:
    - url: https://api.cnevidence.com
  /free/cn/payment/recover:
    post:
      operationId: recover_paid_supplier_report
      summary: Free order status and optional 24h report recovery
      description: Requires the independent random X-CN-Recovery-Token saved and supplied on the original paid HTTP/MCP request. No new charge or upstream call. Not a refund. Never use a public transaction hash or payment signature as the credential. For an uncertain order, an optional transaction_hash triggers read-only finalized Base USDC authorization-and-transfer verification, at most once per minute per order. Inconclusive checks do not release the report or authorize repayment. New opted-in reports have an integrity-checked second local copy within the same 24h window. If both are unavailable before expiry after confirmed settlement, a refund review is recorded, not a transfer. A separate bounded worker handles eligible failures when available; inspect refund status, not a refund promise. This endpoint never transfers funds. Whole-disk recovery is not guaranteed.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - recovery_token
              properties:
                recovery_token:
                  type: string
                  pattern: ^[0-9a-f]{64}$
                  writeOnly: true
                include_report:
                  type: boolean
                  default: true
                transaction_hash:
                  type: string
                  pattern: ^0x[0-9a-fA-F]{64}$
                  description: Optional existing Base transaction to reconcile an uncertain order. Requires the independent recovery token. Never initiates payment.
      responses:
        '200':
          description: Confirmed settlement and original report if requested
        '202':
          description: Settlement not confirmed; reconcile, do not pay again
        '404':
          description: Unknown token/order
        '410':
          description: Recovery window expired
        '422':
          description: Invalid token
        '503':
          description: Recovery temporarily unavailable or stored report unavailable; inspect refund review metadata when present. No refund transfer is implied.
        '409':
          description: Refund reservation requires reconciliation before further report delivery
      tags:
      - Free
    servers:
    - url: https://api.cnevidence.com
  /free/cn/reports:
    get:
      summary: Private paid-analysis delivery requirements
      responses:
        '200':
          description: No upstream call
      tags:
      - Free
      operationId: getFreeCnReports
      x-operation-id-source: derived
    servers:
    - url: https://api.cnevidence.com
  /free/cn/reports/compose:
    post:
      summary: Compose an unreviewed analysis from already settled, bound source orders
      description: No new charge or upstream query. Save a separate recovery token on each purchase. Exact entity and same payer required; 24h expiry; old orders without argument bindings cannot be used.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - recovery_tokens
              properties:
                recovery_tokens:
                  type: array
                  minItems: 1
                  maxItems: 16
                  uniqueItems: true
                  items:
                    type: string
                    pattern: ^[0-9a-f]{64}$
                    writeOnly: true
                format:
                  enum:
                  - json
                  - zh-CN
                  - en
                  default: json
      responses:
        '200':
          description: JSON analysis or private HTML
        '404':
          description: Order unavailable
        '409':
          description: Unconfirmed, expired, refunded, mismatched or unbound evidence
        '422':
          description: Invalid input
        '503':
          description: Unavailable; do not pay again
      tags:
      - Free
      operationId: postFreeCnReportsCompose
      x-operation-id-source: derived
    servers:
    - url: https://api.cnevidence.com
  /free/cn/reports/supplement/availability:
    get:
      summary: Bounded gift-only qualifications supplement availability
      responses:
        '200':
          description: Current admission window, not a delivery guarantee
      tags:
      - Free
      operationId: getFreeCnReportsSupplementAvailability
      x-operation-id-source: derived
    servers:
    - url: https://api.cnevidence.com
  /free/cn/reports/supplement:
    post:
      summary: Opt in to one QCC qualifications supplement for existing settled source orders
      description: No new customer charge. Jinghai first; one accepted QCC check only, fresh gift observation required, no retries or paging. Repeat the identical POST to collect; 24h source-order expiry. Base compose remains independent.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - recovery_tokens
              properties:
                recovery_tokens:
                  type: array
                  minItems: 1
                  maxItems: 16
                  uniqueItems: true
                  items:
                    type: string
                    pattern: ^[0-9a-f]{64}$
                    writeOnly: true
                format:
                  enum:
                  - json
                  - zh-CN
                  - en
                  default: json
      responses:
        '200':
          description: Report with explicit supplement collection status
        '202':
          description: Pending; poll this POST without a new purchase
        '404':
          description: Unavailable order
        '409':
          description: Entitlement or source-set conflict
        '422':
          description: Invalid input
        '503':
          description: Gift window or service unavailable; use base report
      tags:
      - Free
      operationId: postFreeCnReportsSupplement
      x-operation-id-source: derived
    servers:
    - url: https://api.cnevidence.com
  /free/cn/products:
    get:
      summary: Versioned product prices and current availability; no provider call
      responses:
        '200':
          description: Existing prices unchanged; unavailable products cannot be bought
      tags:
      - Free
      operationId: getFreeCnProducts
      x-operation-id-source: derived
    servers:
    - url: https://api.cnevidence.com
  /free/cn/products/recover:
    post:
      summary: Recover original paid product without extra calls; HTML only for screening…
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - recovery_token
              properties:
                recovery_token:
                  type: string
                  pattern: ^[0-9a-f]{64}$
                  writeOnly: true
                format:
                  enum:
                  - json
                  - zh-CN
                  - en
      responses:
        '200':
          description: Private original report
        '202':
          description: Settlement unconfirmed
        '404':
          description: Unknown order
        '409':
          description: Not a bundle/refund conflict
        '410':
          description: Expired
        '422':
          description: Invalid request
        '503':
          description: Unavailable
      tags:
      - Free
      operationId: postFreeCnProductsRecover
      x-operation-id-source: derived
    servers:
    - url: https://api.cnevidence.com
  /free/cn/tools:
    get:
      summary: Local data-tool schemas and prices; no upstream query
      responses:
        '200':
          description: Enabled tool catalog
      tags:
      - Free
      operationId: getFreeCnTools
      x-operation-id-source: derived
    servers:
    - url: https://api.cnevidence.com
x-refined-from:
- cnevidence-com-openapi.json
- cnevidence-com-openapi.yml