Batch, rates y errores.

Ingesta batch (≤100)

Un solo request JSON con hasta 100 mensajes. Cada ítem lleva su propio idempotency_key. La respuesta lista resultados por índice y contadores created / failed / replayed.

curl -s -X POST "$MAILACK_API_URL/v1/messages/batch" \
  -H "Authorization: Bearer $MAILACK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "idempotency_key": "order-1",
        "from": "noreply@acme.mx",
        "to": "a@ejemplo.com",
        "subject": "Pedido 1",
        "text": "Gracias"
      },
      {
        "idempotency_key": "order-2",
        "from": "noreply@acme.mx",
        "to": "b@ejemplo.com",
        "subject": "Pedido 2",
        "text": "Gracias"
      }
    ]
  }' | jq .

Rates de entregabilidad

Agregados del tenant en una ventana de días (query days, default 14): ingested, sent, deferred, bounced, complained, sealed, tasas y serie diaria. Misma forma en el portal (pantalla Rates).

Son métricas operativas del tenant, no un claim de entregabilidad pública del producto.

curl -s "$MAILACK_API_URL/v1/rates?days=14" \
  -H "Authorization: Bearer $MAILACK_API_KEY" | jq .

Scopes de API key

La key Bearer resuelve el tenant. Scopes habituales:

Envelope y códigos

Formato uniforme: {"error":{"code":"snake_case","message":"…"}}. Códigos frecuentes de producto:

Machine, portal y admin

Machine API (/v1/* con API key) es la de SDKs y MCP. Portal (/v1/portal/*) usa sesión del usuario del cliente. Admin (/v1/admin/*) es la consola de operadores JAAK.