Autenticação e erros

curl -X GET "https://signer.vcc-service.com/v1/envelopes" \
  -H "x-api-key: SEU_API_KEY"

curl -X GET "https://signer.vcc-service.com/v1/envelopes/uuid/signed-document" \
  -H "Authorization: Bearer BEARER_TOKEN" \
  -H "x-project-id: SEU_PROJECT_ID" \
  -H "x-organization-id: SEU_ORGANIZATION_ID"

curl -X GET "https://signer.vcc-service.com/v1/sign/abc123xyz/preview" \
  -H "Content-Type: application/json"

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "statusCode": 400,
  "message": "Unique constraint violation on field(s): externalCode",
  "error": {
    "code": "DUPLICATE_EXTERNAL_CODE",
    "details": "O código externo 'FAT-2025-001' já existe para este projeto."
  }
}

// Pseudocódigo
try {
  const response = await fetch("https://signer.vcc-service.com/v1/envelopes", {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ /* ... */ })
  });

  if (!response.ok) {
    const error = await response.json();
    
    // statusCode 401 → credenciais inválidas
    if (error.statusCode === 401) {
      console.error("Autenticação falhou:", error.message);
      // Tente refrescar a chave de API ou token
    }
    
    // statusCode 400 → validação
    if (error.statusCode === 400) {
      console.error("Entrada inválida:", error.message);
      // Retorne ao usuário para corrigir
    }
    
    // statusCode 5xx → servidor indisponível
    if (error.statusCode >= 500) {
      console.error("Erro no servidor, tente novamente em breve");
      // Implemente retry com backoff exponencial
    }
    
    throw new Error(error.message);
  }
  
  const data = await response.json();
  return data;
} catch (err) {
  console.error("Erro na requisição:", err);
}