Documentación de la API

https://tu-dominio.com

Authorization: Bearer er_5d77432280424e8cafeee6d52ef00ad1

x-ratelimit-limit: 60        # límite de la ventana
x-ratelimit-remaining: 58    # peticiones restantes
x-ratelimit-reset: 1716120600 # Unix timestamp (UTC) del reset

{ "error": "descripción del error" }

POST /v1/signup
content-type: application/json

{ "email": "tú@ejemplo.com" }

{
  "account_id":  "58d3914b-d535-4c3a-ac77-1acf61751e52",
  "email":       "tú@ejemplo.com",
  "api_key":     "er_5d77432280424e8cafeee6d52ef00ad1",  // ⚠ solo aquí
  "credits":     25,
  "message":     "Guarda tu api_key, no se mostrará de nuevo."
}

{
  "data": [
    {
      "id":          "010b6365-bdab-49ad-8b81-954a205ff578",
      "name":        "Factura",
      "source":      "<h1>Hola, {{nombre}}</h1>...",
      "webhook_url": "https://mi-app.com/hooks/render",  // null si no configurado
      "updated_at":  "2026-05-19 10:30:00",
      "created_at":  "2026-05-18 09:00:00"
    }
  ]
}

POST /v1/templates
authorization: Bearer er_••••••••••••••••

{
  "name":        "Factura",
  "source":      "<h1>Factura {{numero}}</h1><p>{{cliente}}</p>",
  "test_data":   "{\"numero\":\"2026-001\",\"cliente\":\"Acme S.L.\"}",
  "webhook_url": "https://mi-app.com/hooks/render"
}

{
  "id":          "010b6365-bdab-49ad-8b81-954a205ff578",
  "name":        "Factura",
  "source":      "<h1>Factura {{numero}}</h1><p>{{cliente}}</p>",
  "test_data":   "{\"numero\":\"2026-001\",\"cliente\":\"Acme S.L.\"}",
  "webhook_url": "https://mi-app.com/hooks/render"
}

{
  "id":          "010b6365-bdab-49ad-8b81-954a205ff578",
  "name":        "Factura",
  "source":      "<h1>Factura {{numero}}</h1>...",
  "test_data":   "{\"numero\":\"2026-001\",\"cliente\":\"Acme S.L.\"}",
  "webhook_url": "https://mi-app.com/hooks/render",
  "updated_at":  "2026-05-19 10:30:00",
  "created_at":  "2026-05-18 09:00:00"
}

{ "deleted": true }

content-type: application/pdf        # o text/html, image/png, image/jpeg
x-credits-charged: 3                 # créditos descontados en esta llamada
x-credits-remaining: 22              # saldo tras el descuento
x-ratelimit-remaining: 57

x-credits-refunded: 3
x-credits-remaining: 25              # saldo tras el reembolso
{ "error": "...", "credits_refunded": 3 }

POST /v1/render
authorization: Bearer er_••••••••••••••••
content-type: application/json

{
  "template_id": "010b6365-bdab-49ad-8b81-954a205ff578",
  "data": { "cliente": "Acme S.L.", "total": "1.240,00 €" },
  "format": "pdf",
  "pdf": {
    "paper": "A4",
    "landscape": false,
    "margin": { "top": "2cm", "right": "1.5cm", "bottom": "2cm", "left": "1.5cm" },
    "footerTemplate": "<div style='font-size:9px;text-align:right;width:100%;padding-right:1cm'><span class='pageNumber'></span>/<span class='totalPages'></span></div>"
  },
  "waitUntil": "load"
}

# ← 200 OK · Content-Type: application/pdf · x-credits-charged: 3

"<div style='font-size:9px;font-family:sans-serif;color:#666;
             width:100%;text-align:right;padding-right:1cm'>
  Pág. <span class='pageNumber'></span>
  de <span class='totalPages'></span>
</div>"

{
  "template_id": "…",
  "data": { "titulo": "Mi artículo" },
  "format": "png",
  "image": {
    "width": 1200,
    "height": 630,
    "deviceScaleFactor": 2,   // → imagen de 2400×1260 px
    "fullPage": false
  },
  "waitUntil": "load"
}

{
  "source": "<div style='padding:20px'><h1 style='color:#f0a830'>{{marca}}</h1></div>",
  "data": { "marca": "EasyRender" },
  "format": "png",
  "image": { "width": 400, "height": 100, "omitBackground": true, "fullPage": false }
}

STRIPE_SECRET_KEY=sk_live_…
STRIPE_WEBHOOK_SECRET=whsec_…
STRIPE_CREDIT_PACKS={"price_1Abc":1000,"price_1Def":5000}
                     # price_id → créditos que otorga

POST /v1/coupons/redeem
authorization: Bearer er_••••••••••••••••
content-type: application/json

{ "code": "PROMO25" }

{
  "success":         true,
  "credits_granted": 25
}

{
  "data": [
    {
      "id":         "f3a1c2d4-…",
      "label":     "producción",   // null si sin etiqueta
      "revoked":   0,              // 0 = activa · 1 = revocada
      "created_at": "2026-05-19 10:00:00"
    }
  ]
}

POST /v1/api-keys
authorization: Bearer er_••••••••••••••••
content-type: application/json

{ "label": "staging" }

{
  "id":      "f3a1c2d4-…",
  "label":   "staging",
  "api_key": "er_9f3c1a…"   // ⚠ solo aquí
}

{ "revoked": true }