Ejemplos de código

Ejemplos mínimos para autenticación, listar documentos y crear un socio de negocio. Sustituya TU_KEY_ID, TU_SECRET y la URL base por sus valores reales.

cURL

Autenticación en cada petición

export KEY_ID="abk_xxxx"
export SECRET="su_secret"
export BASE="https://api.abaco.hn"

curl -X GET "$BASE/documents?page=1&limit=5" \
  -H "Authorization: Bearer $KEY_ID:$SECRET"

Crear un socio de negocio

curl -X POST "$BASE/business-partners" \
  -H "Authorization: Bearer $KEY_ID:$SECRET" \
  -H "Content-Type: application/json" \
  -d '{"name":"Cliente Ejemplo","taxId":"0801-1990-12345","type":"C","email":"cliente@ejemplo.com"}'

Node.js (fetch)

const BASE = 'https://api.abaco.hn';
const KEY_ID = 'abk_xxxx';
const SECRET = 'su_secret';
const token = `${KEY_ID}:${SECRET}`;

// Listar documentos
const res = await fetch(`${BASE}/documents?page=1&limit=10`, {
  headers: { Authorization: `Bearer ${token}` },
});
if (!res.ok) {
  if (res.status === 429) throw new Error('Rate limit; reintentar más tarde');
  if (res.status === 401) throw new Error('API key inválida');
  throw new Error(await res.text());
}
const data = await res.json();
console.log(data.documents);

Python (requests)

import os
import requests

BASE = os.environ.get("ABACO_API_BASE", "https://api.abaco.hn")
KEY_ID = os.environ.get("ABACO_KEY_ID", "abk_xxxx")
SECRET = os.environ.get("ABACO_SECRET", "su_secret")
token = f"{KEY_ID}:{SECRET}"

headers = {"Authorization": f"Bearer {token}"}

# Listar documentos
r = requests.get(f"{BASE}/documents", params={"page": 1, "limit": 10}, headers=headers)
if r.status_code == 429:
    raise Exception("Rate limit; esperar y reintentar")
if r.status_code == 401:
    raise Exception("API key inválida")
r.raise_for_status()
data = r.json()
print(data["documents"])

Manejo de errores 401 y 429

• 401: Verificar que Key ID y Secret sean correctos y que la llave no esté revocada o expirada. Ver Autenticación.
• 429: Esperar unos segundos y reintentar con backoff (ej. 2 s, 4 s, 8 s). Ver Límites y cuotas.

Referencia de API · Autenticación