{
  "openapi": "3.1.0",
  "info": { "title": "SupplementAbsorption.com free API", "version": "0.1.0",
    "description": "Read-only JSON of supplement absorption evidence. Values are copied as printed in cited studies (PMID/DOI) with species labels. Grades are drafts pending reviewer sign-off. Educational, not medical advice." },
  "servers": [{ "url": "https://supplementabsorption.com" }],
  "paths": {
    "/api/supplements.json": { "get": { "summary": "List supplements with grades, forms and measured-PK summary", "operationId": "listSupplements", "responses": { "200": { "description": "OK", "content": { "application/json": {} } } } } },
    "/api/supplements/{slug}.json": { "get": { "summary": "Full evidence for one supplement (studies, forms, head-to-head and indirect comparisons, measured PK values with citations)", "operationId": "getSupplement",
      "parameters": [{ "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "enum": ["magnesium", "iron", "curcumin", "vitamin-d", "coq10", "zinc", "omega-3", "vitamin-b12", "calcium", "creatine", "cbd", "cbda"] }, "description": "cbda is an alias of cbd" }],
      "responses": { "200": { "description": "OK", "content": { "application/json": {} } } } } },
    "/api/supplements/{slug}/sections/{anchor}.json": { "get": { "summary": "One page section (e.g. forms, with-food, a form pair anchor)", "operationId": "getSection",
      "parameters": [{ "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "anchor", "in": "path", "required": true, "schema": { "type": "string" } }],
      "responses": { "200": { "description": "OK", "content": { "application/json": {} } } } } }
  }
}