Exemplos em PHP e JavaScript

As rotas abaixo foram confirmadas na implementação da API V1. Use sempre uma credencial de integração com a permissão necessária.

PHP — consultar produtos (servidor)

<?php
$token = getenv('AUDACIA_API_TOKEN');
$ch = curl_init('https://audacia.com.br/api/v1/products?per_page=20');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer '.$token,
    ],
    CURLOPT_TIMEOUT => 15,
]);
$result = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($result === false) {
    throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
if ($code < 200 || $code >= 300) {
    throw new RuntimeException('A API retornou HTTP '.$code);
}
$data = json_decode($result, true, flags: JSON_THROW_ON_ERROR);

A permissão requerida é products.read. Use variáveis de ambiente ou gerenciador de segredos, não código-fonte público.

JavaScript — no backend Node.js

const token = process.env.AUDACIA_API_TOKEN;
if (!token) throw new Error('Token ausente');
const response = await fetch('https://audacia.com.br/api/v1/customers?per_page=20', {
  headers: {
    Accept: 'application/json',
    Authorization: `Bearer ${token}`,
  },
  signal: AbortSignal.timeout(15000),
});
if (!response.ok) throw new Error(`Audácia HTTP ${response.status}`);
const payload = await response.json();

A permissão requerida é customers.read. Não coloque o token no JavaScript de uma página pública. Use exclusivamente código executado no servidor, evitando exposição aos visitantes.

Tratamento de erros

Um 422 decorrente dos validadores ApiFormRequest apresenta success: false, uma mensagem e errors por campo. Para 401, 403, 429 e erros de rede, registre o HTTP e trate conforme sua política de integração; a disponibilidade e os limites específicos de cada rota devem ser verificados no ambiente ativo. Não presuma tentativas automáticas seguras para operações de gravação.