# Verificar se a API está no ar

> Não exige chave e não consome cota. Responde 503 quando a API está desligada ou o disjuntor está aberto.

URL: https://precificador3d.com.br/docs/api/referencia/saude

`GET https://api.precificador3d.com.br/v1/saude`

Não exige chave e não consome cota. Responde 503 quando a API está desligada ou o disjuntor está aberto.

Não exige chave.

## Resposta 200

API no ar.

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `situacao` | string, sempre "ok" | sim |  |

```json
{
  "situacao": "ok"
}
```

## Outras respostas

- **429** (`limite_excedido`): Limite de uso excedido (rajada, minuto, mês ou requisições simultâneas).
- **503** (`indisponivel`): API desligada, sob pressão (disjuntor aberto) ou no limite global da plataforma.

## Exemplos

**cURL**

```bash
curl "https://api.precificador3d.com.br/v1/saude"
```

**JavaScript**

```js
const resposta = await fetch('https://api.precificador3d.com.br/v1/saude', {
});
if (!resposta.ok) {
  const erro = await resposta.json(); // application/problem+json
  throw new Error(`${erro.codigo}: ${erro.detail} (${erro.requisicao_id})`);
}
const dados = await resposta.json();
```

**Python**

```python
import os

import requests

resposta = requests.get(
    "https://api.precificador3d.com.br/v1/saude",
    timeout=10,
)
resposta.raise_for_status()
dados = resposta.json()
```