AcuiQ Meridians API

openapi: 3.2.0
info:
  title: AcuiQ Meridians API
  version: 2.1.0
  description: 'Acupuncture protocol matching API. Search symptoms, browse meridians, find treatment protocols and search the reference wiki – no account and no API key. Two bulk exports carry a per-request charge over MPP (Machine Payments Protocol), paid through Stripe; every per-query endpoint is free. Licence scope: AcuiQ-authored prose (symptom and meridian descriptions, the wiki, the auricular crosswalk) is licensed CC-BY-4.0: https://creativecommons.org/licenses/by/4.0/. The assembled protocol compilation is not: build on it with attribution, but do not redistribute it whole as a dataset – https://acuiq.com/terms. The underlying findings are the cited sources'' claims – each entry carries its citation; verify against the source before relying on it. Not medical advice: https://acuiq.com/terms'
  contact:
    name: AcuiQ
    url: https://acuiq.com
  license:
    name: Creative Commons Attribution 4.0 International
    identifier: CC-BY-4.0
servers:
- url: https://acuiq.com
  description: Production
tags:
- name: Meridians
paths:
  /api/meridians:
    get:
      operationId: getMeridians
      summary: List all meridians
      description: 'Returns all TCM meridians with descriptions and element associations. The whole point catalogue in one response. Rate limit: 100 req/min. Priced at $0.50 over MPP (Machine Payments Protocol); a payment does not lift the rate limit, and a throttled payment is refunded.'
      x-payment-info:
        method: stripe
        intent: charge
        amount: '50'
        currency: usd
        description: The whole AcuiQ point catalogue in one response.
      security:
      - payment: []
      responses:
        '200':
          description: Meridian list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeridianListResponse'
        '402':
          description: 'Payment required. The WWW-Authenticate: Payment header carries the challenge; the body states the price and lists the free alternatives.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Meridians
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
          enum:
          - RATE_LIMITED
          - INVALID_PARAMS
          - NOT_FOUND
          - SERVICE_ERROR
          - PAYMENT_REQUIRED
      required:
      - error
    MeridianListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
        error:
          type: string
        code:
          type: string
  securitySchemes:
    payment:
      type: http
      scheme: Payment
      description: 'MPP (Machine Payments Protocol) (https://mpp.dev), method "stripe", paid with a Stripe shared payment token (SPT), single use scoped to Stripe profile profile_61VcHMvCI7idwYC2zA6VcHMv8oE9roGsBkZRtDHSi0ng. Request the resource without it, answer the WWW-Authenticate challenge from the 402, and retry with Authorization: Payment. Only the two bulk exports use this; everything else on this spec is free and anonymous.'