Tratamento de Erros

const response = await fetch(url, {
  headers: { "X-API-Key": "fapi_sua_chave_aqui" },
});

if (!response.ok) {
  const error = await response.json();
  console.error(`[${error.title}] ${error.detail}`);

  switch (error.status) {
    case 400:
      // Corrija os parametros da requisicao
      throw new Error(`Parametro invalido: ${error.detail}`);
    case 403:
      if (error.title === "ACESSO_NEGADO") {
        // Chave valida sem acesso a este endpoint (ex.: chave demo)
        throw new Error(`Acesso negado: ${error.detail}`);
      }
      // API_KEY_ERROR: chave ausente, invalida ou revogada
      throw new Error("Credenciais invalidas");
    case 429:
      // Limite excedido — aguarde e tente novamente
      const retryAfter = response.headers.get("Retry-After");
      await new Promise((r) => setTimeout(r, retryAfter * 1000));
      // Reenviar requisicao...
      break;
    case 502:
    case 503:
      // Fonte indisponivel — retry com backoff exponencial
      break;
    default:
      throw new Error(`Erro inesperado: ${error.detail}`);
  }
}

const data = await response.json();

import requests
import time

response = requests.get(url, headers={"X-API-Key": "fapi_sua_chave_aqui"})

if not response.ok:
    error = response.json()
    print(f"[{error['title']}] {error['detail']}")

    if response.status_code == 429:
        retry_after = int(response.headers.get("Retry-After", 60))
        time.sleep(retry_after)
        # Reenviar requisicao...
    elif response.status_code in (502, 503):
        # Retry com backoff exponencial
        pass
    elif response.status_code == 400:
        raise ValueError(f"Parametro invalido: {error['detail']}")
    elif response.status_code == 403:
        if error["title"] == "ACESSO_NEGADO":
            # Chave valida sem acesso a este endpoint (ex.: chave demo)
            raise PermissionError(f"Acesso negado: {error['detail']}")
        # API_KEY_ERROR: chave ausente, invalida ou revogada
        raise PermissionError("API Key invalida")

data = response.json()

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get($url);

if ($response->failed()) {
    $error = $response->json();
    Log::error("[{$error['title']}] {$error['detail']}");

    if ($response->status() === 429) {
        $retryAfter = $response->header('Retry-After') ?? 60;
        sleep((int) $retryAfter);
        // Reenviar requisicao...
    }
}

$data = $response->json();