Primeiros passos com a IaBula API

1. Escolha seu canal de acesso#

No acesso direto, crie sua conta e utilize a gestão de chaves do Customer Portal. Na RapidAPI, abra o listing da IaBula, escolha um plano e siga o mecanismo nativo de autenticação do marketplace. Não envie sua chave a esta documentação.

2. Configure seu ambiente#

Defina IABULA_API_BASE como https://api.iabula.com para o serviço publicado. Configure IABULA_API_KEY em um gerenciador de segredos ou variável de ambiente no servidor. Os exemplos pressupõem que você já possui uma chave válida; nenhuma credencial é incluída aqui.

export IABULA_API_BASE="https://api.iabula.com"

3. Faça sua primeira busca#

curl --fail-with-body --get "$IABULA_API_BASE/v1/medications/search" \
  --header "X-API-Key: $IABULA_API_KEY" \
  --data-urlencode 'q=dipirona' \
  --data-urlencode 'limit=20'

// Run on your server. Keep the API key out of browser bundles.
const url = new URL("/v1/medications/search", process.env.IABULA_API_BASE);
url.search = new URLSearchParams({ q: "dipirona", limit: "20" });
const response = await fetch(url, {
  headers: { "X-API-Key": process.env.IABULA_API_KEY },
});
const page = await response.json();
if (!response.ok) throw new Error(`${response.status}: ${page.code}`);
console.log(page.data, page.next_cursor);

import json
import os
from urllib.parse import urlencode
from urllib.request import Request, urlopen

base = os.environ["IABULA_API_BASE"].rstrip("/")
query = urlencode({"q": "dipirona", "limit": 20})
request = Request(
    f"{base}/v1/medications/search?{query}",
    headers={"X-API-Key": os.environ["IABULA_API_KEY"]},
)
with urlopen(request, timeout=15) as response:
    page = json.load(response)
print(page["data"], page["next_cursor"])

A resposta é uma página com data e next_cursor. data contém registros MedicationSummary; uma busca sem correspondências pode retornar uma lista vazia. Para continuar, envie next_cursor em cursor e mantenha os filtros originais.

4. Inspecione e integre#

No Playground, entre com uma conta ativa e e-mail verificado. A execução usa a sessão e o acesso vinculado à conta, com os limites do plano; você não precisa colar uma chave no modo padrão. Para uma integração fora do Playground, continue usando X-API-Key no canal direto ou as credenciais nativas da RapidAPI.

Antes de integrar, defina como tratar listas vazias, campos nulos, cursores e respostas 429. Faça retries limitados e respeite Retry-After. Leia a proveniência antes de atribuir significado regulatório a um campo.