Visão Geral da API

https://api.sinapse.org.br/v1/recurso

Content-Type: application/json
Accept: application/json
Authorization: Bearer SEU_TOKEN_AQUI
X-Request-ID: uuid-unico-requisicao

{
  "data": {
    "id": 123,
    "nome": "João Silva",
    "email": "[email protected]"
  },
  "meta": {
    "timestamp": "2025-07-29T10:30:00Z",
    "version": "1.0.0"
  }
}

{
  "total": 150,
  "page": 1,
  "size": 50,
  "pages": 3,
  "items": [
    {
      "id": 1,
      "nome": "Item 1"
    },
    {
      "id": 2,
      "nome": "Item 2"
    }
  ],
  "meta": {
    "timestamp": "2025-07-29T10:30:00Z"
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Erro de validação nos dados enviados",
    "details": [
      {
        "field": "email",
        "message": "Email inválido",
        "code": "INVALID_EMAIL"
      }
    ],
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-07-29T10:30:00Z"
  }
}

GET /api/v1/agravos/casos?page=2&size=25&sort=data_notificacao&order=desc

{
  "total": 523,
  "page": 2,
  "size": 25,
  "pages": 21,
  "items": [...],
  "links": {
    "first": "/api/v1/agravos/casos?page=1&size=25",
    "prev": "/api/v1/agravos/casos?page=1&size=25",
    "next": "/api/v1/agravos/casos?page=3&size=25",
    "last": "/api/v1/agravos/casos?page=21&size=25"
  }
}

GET /api/v1/agravos/casos?tipo_agravo=dengue&estado=SP&municipio=São Paulo

# Busca com múltiplas condições
GET /api/v1/agravos/casos?search={
  "and": [
    {"tipo_agravo": "dengue"},
    {"estado": "SP"},
    {"or": [
      {"classificacao": "grave"},
      {"idade": {"gt": 60}}
    ]}
  ]
}

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 834
X-RateLimit-Reset: 1627654800
X-RateLimit-Reset-After: 3600

async function requestWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);
    
    if (response.status !== 429) {
      return response;
    }
    
    // Extrair tempo de espera do header
    const retryAfter = response.headers.get('Retry-After') || 60;
    console.log(`Rate limit atingido. Aguardando ${retryAfter}s...`);
    
    // Esperar com backoff exponencial
    await new Promise(resolve => 
      setTimeout(resolve, (retryAfter * 1000) * Math.pow(2, i))
    );
  }
  
  throw new Error('Rate limit excedido após múltiplas tentativas');
}

POST /api/v1/agravos/casos/bulk
Content-Type: application/json

{
  "arquivo": "base64_encoded_file",
  "formato": "csv"
}

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "status_url": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000",
  "message": "Processamento iniciado"
}

GET /api/v1/jobs/550e8400-e29b-41d4-a716-446655440000

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "progress": 100,
  "result": {
    "total_processados": 1500,
    "sucesso": 1485,
    "erros": 15
  },
  "created_at": "2025-07-29T10:00:00Z",
  "completed_at": "2025-07-29T10:05:32Z"
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Dados inválidos",
    "details": [
      {
        "field": "data_nascimento",
        "message": "Data deve estar no formato YYYY-MM-DD",
        "code": "INVALID_FORMAT"
      },
      {
        "field": "cpf",
        "message": "CPF inválido",
        "code": "INVALID_CPF"
      }
    ]
  }
}

# Português (padrão)
Accept-Language: pt-BR

# Inglês
Accept-Language: en-US

# Espanhol
Accept-Language: es-ES

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS
Access-Control-Allow-Headers: Content-Type, Authorization
Access-Control-Max-Age: 86400

// Configuração no cliente
const response = await fetch('https://api.sinapse.org.br/v1/recurso', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer TOKEN',
    'Content-Type': 'application/json'
  },
  mode: 'cors',
  credentials: 'include'
});

POST /api/v1/webhooks
Content-Type: application/json
Authorization: Bearer TOKEN

{
  "url": "https://seu-sistema.com/webhook",
  "eventos": ["agravo.criado", "agravo.atualizado"],
  "ativo": true,
  "headers": {
    "X-Custom-Header": "valor"
  }
}

{
  "id": "evt_550e8400-e29b-41d4-a716-446655440000",
  "tipo": "agravo.criado",
  "timestamp": "2025-07-29T10:30:00Z",
  "dados": {
    "id": 123,
    "tipo_agravo": "dengue",
    "numero_notificacao": "2025-001234"
  },
  "webhook_id": "wh_123456"
}

import hmac
import hashlib

def verificar_webhook(payload, signature, secret):
    expected = hmac.new(
        secret.encode(),
        payload.encode(),
        hashlib.sha256
    ).hexdigest()
    
    return hmac.compare_digest(expected, signature)