Documentación de la API de AccesPub

La API de AccesPub hace accesibles vuestros EPUB por lotes desde vuestros propios sistemas: convierte a EPUB 3, corrige todo lo automático, deja para una persona lo que necesita criterio (texto alternativo, tablas, idiomas) y entrega el EPUB con su informe y su ONIX 3.1 de accesibilidad. Cuando no queda nada pendiente y EPUBCheck no encuentra errores, el EPUB incluye la declaración de conformidad WCAG 2.1 AA, que es una declaración del editor, no una certificación.

Dos formas de trabajar

  • Solo portal: sin programar, todo en el portal de AccesPub.
  • Modelo mixto: vuestro sistema crea los lotes, sube los EPUB, envía metadatos y datos comerciales y descarga los resultados por la API; la revisión humana se hace en el portal, al que vuestro frontal enlaza. Ver «Modelo mixto» en la guía de integración.

Por dónde empezar

Recurso Para qué
Guía de integración Primeros pasos, ciclo de vida de un trabajo, revisión humana, salidas, errores y créditos. Empezad por aquí.
Guía práctica Cada operación, una a una, explicada en lenguaje llano y con el código listo para ejecutar en curl, Python y JavaScript. Pensada también para perfiles técnicos que no programan.
Referencia Todas las operaciones, parámetros, respuestas y esquemas, generada desde el contrato.
openapi.yaml El contrato OpenAPI 3.1, para importarlo en Postman, Insomnia o Bruno o generar clientes.
Ejemplo en Python Un EPUB de principio a fin, con revisión interactiva en el terminal.
Ejemplo en Node.js El mismo recorrido en JavaScript, sin dependencias.
Ayuda del portal Para quien revisa en el portal web de AccesPub (ES · EN · CA · FR).
La API en vídeo Un EPUB de principio a fin con llamadas reales, en dos minutos, con subtítulos y transcripción.

En cinco minutos

  1. Pedid una clave de prueba (ap_test_…) a quien administre vuestra cuenta, o creadla en el portal (Organización → Claves de API). Las claves de prueba no consumen créditos y sus datos están separados de los reales.
  2. Probadla:
curl -s https://api.accespub.app/v1/organization \
  -H "Authorization: Bearer ap_test_..."
  1. Ejecutad el ejemplo con un EPUB vuestro:
pip install requests
export ACCESPUB_KEY=ap_test_...
python quickstart.py mi-libro.epub

Lo esencial

  • Base: https://api.accespub.app/v1. Autenticación con Authorization: Bearer <clave>.
  • Asíncrona: subir un EPUB devuelve 202 y un trabajo en cola; consultad su estado hasta que esté listo.
  • La IA solo propone: las decisiones las toma una persona registrada en vuestra organización, y cada una queda firmada.
  • Créditos: se consumen al finalizar por primera vez cada título (1 crédito hasta 150 imágenes; uno más por cada 150 adicionales). Las claves de prueba nunca consumen.
  • Errores en application/problem+json (RFC 9457) e idempotencia con la cabecera Idempotency-Key.

¿Dudas técnicas? info@abserveis.net