API REST

AZbox publica librerías para tres stacks: Dart/Flutter en pub.dev, Node.js en npm y PHP en Packagist. Cualquier otro stack — React Native, iOS o Android nativos, Vue, Angular, Go, Python — se integra a través de esta API.

Preferimos decirlo aquí a que pierdas una tarde buscando un SDK que no existe.

Obtener las keywords de un proyecto

GET https://api.azbox.io/v1/projects/{projectId}/keywords

Parámetro	En	Obligatorio	Descripción
projectId	ruta	sí	El ID de tu proyecto, en el panel
token	query	sí	Tu clave de API
language	query	sí	Código de idioma: EN, ES, PT…
afterUpdatedAtStr	query	no	Fecha ISO. Devuelve solo las keywords actualizadas después

Ejemplo

curl "https://api.azbox.io/v1/projects/TU_PROJECT_ID/keywords?token=TU_API_KEY&language=ES"

Respuesta

Un array de keywords. Cada una lleva su id y sus datos:

[
  {
    "id": "home.title",
    "data": {
      "translation": "Bienvenido a AZbox",
      "context": null,
      "updatedAt": "2026-09-02T10:14:00.000Z"
    }
  }
]

Sincronizar solo lo que ha cambiado

Pasa afterUpdatedAtStr con la marca de tiempo de tu última sincronización y recibirás únicamente las keywords tocadas desde entonces. Esto es lo que hace practicables las actualizaciones over-the-air: corriges un texto en el panel y tu siguiente refresco lo recoge sin desplegar y sin pasar por la store.

curl "https://api.azbox.io/v1/projects/TU_PROJECT_ID/keywords?token=TU_API_KEY&language=ES&afterUpdatedAtStr=2026-09-01T00:00:00.000Z"

Guarda la marca de tiempo de la respuesta que aplicaste, no la hora actual, o perderás todo lo que se escriba mientras tu petición viaja.

Antes de ponerte a construir

• La API es de solo lectura para keywords. Se crean en el panel o importando un archivo. Aquí no hay ningún endpoint que las suba.
• Una petición por idioma. No hay respuesta combinada.
• La interpolación es cosa tuya. Los textos vuelven tal y como están guardados, con sus placeholders. Sustituir {count} y compañía te toca a ti.
• Cachea el resultado. Una petición por texto en tiempo de render va a ir lenta. Pide una vez al arrancar y refresca cada cierto tiempo.
• Guarda el token en el servidor siempre que puedas. Viaja como parámetro de query, así que acaba en los logs de acceso, en los proxys y en el historial del navegador si llamas a la API directamente desde el cliente.

Implementación de referencia

El cliente de Node son unas cien líneas y hace exactamente esto y nada más. Si vas a escribir un cliente para otro lenguaje, es lo más corto que puedes leer: azbox-node en npm.

Para los tres stacks que sí tienen librería, empieza mejor por la guía rápida: Flutter, Node.js o PHP.