{
 "openapi": "3.1.0",
 "info": {
  "title": "SmartDrugs API",
  "version": "1.0.0",
  "summary": "Fichas de substâncias (nootrópicos, peptídeos, cogumelos, canabinoides) com fontes.",
  "description": "API pública e só de leitura do SmartDrugs. Conteúdo educacional. Não substitui orientação médica; não faz diagnóstico nem prescrição. Sem autenticação. Cite a URL da ficha ao reutilizar o conteúdo.",
  "contact": {
   "name": "SmartDrugs",
   "url": "https://smartdrugs.com.br/contato/"
  }
 },
 "servers": [
  {
   "url": "https://smartdrugs.com.br"
  }
 ],
 "externalDocs": {
  "url": "https://smartdrugs.com.br/desenvolvedores/",
  "description": "Documentação para desenvolvedores e agentes"
 },
 "paths": {
  "/api/v1/substancias.json": {
   "get": {
    "operationId": "listarSubstancias",
    "summary": "Lista todas as fichas (resumo, objetivos, tipo, links e molécula).",
    "responses": {
     "200": {
      "description": "Lista de fichas",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "total": {
           "type": "integer"
          },
          "substancias": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Resumo"
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/substancias/{slug}.json": {
   "get": {
    "operationId": "obterFicha",
    "summary": "Ficha completa: mecanismo, evidência, efeitos, doses de estudo, regulação e fontes.",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "pattern": "^[a-z0-9-]+$"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Ficha",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "Ficha não encontrada"
     }
    }
   }
  },
  "/api/v1/objetivos.json": {
   "get": {
    "operationId": "listarObjetivos",
    "summary": "Objetivos (foco, memória, sono…) com contagem de fichas e feed.",
    "responses": {
     "200": {
      "description": "Objetivos",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/public/substances": {
   "get": {
    "operationId": "substanciasAoVivo",
    "summary": "Lista das fichas aprovadas, direto do banco do site.",
    "responses": {
     "200": {
      "description": "Fichas",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/public/substances/{slug}": {
   "get": {
    "operationId": "fichaAoVivo",
    "summary": "Ficha aprovada, direto do banco do site.",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Ficha",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "Não encontrada"
     }
    }
   }
  },
  "/api/public/categories": {
   "get": {
    "operationId": "categorias",
    "summary": "Categorias (objetivos) do site.",
    "responses": {
     "200": {
      "description": "Categorias",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/public/articles": {
   "get": {
    "operationId": "artigos",
    "summary": "Artigos publicados.",
    "responses": {
     "200": {
      "description": "Artigos",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/feed.xml": {
   "get": {
    "operationId": "feed",
    "summary": "Feed RSS com artigos e fichas (com imagem). Há feeds por objetivo em /feed/<objetivo>.xml.",
    "responses": {
     "200": {
      "description": "RSS 2.0",
      "content": {
       "application/rss+xml": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/health": {
   "get": {
    "operationId": "saude",
    "summary": "Situação do serviço.",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "ok": {
           "type": "boolean"
          }
         }
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "Resumo": {
    "type": "object",
    "properties": {
     "slug": {
      "type": "string"
     },
     "nome": {
      "type": "string"
     },
     "tipo": {
      "type": "string"
     },
     "objetivos": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "resumo": {
      "type": "string"
     },
     "url": {
      "type": "string",
      "format": "uri"
     },
     "url_markdown": {
      "type": "string",
      "format": "uri"
     },
     "imagem": {
      "type": "string",
      "format": "uri"
     }
    },
    "required": [
     "slug",
     "nome",
     "url"
    ]
   }
  }
 }
}
