dotepub

English | Español | Català
Nubífero hacedor de e-books monoclic
URL
https://dotepub.com/v1/post
Métodos de petición aceptados
POST.
Formatos de respuesta
EPUB, MOBI, XML (en caso de error).
Autenticación requerida
Falso.
Tasa límite
30 peticiones por hora desde la misma dirección IP de host. Te animamos encarecidamente a mantener en una caché el e-book generado.
Parámetros

html (requerido)

Formato: Cualquier fragmento XHTML bien formado codificado en UTF-8.

Descripción: Será el contenido del e-book. Debe ser un texto de menos de 300 Kb. Algunas etiquetas típicas aceptadas son: div, p, em, strong, blockquote, ul, ol, li... dotEPUB no comprobará la validez del XHTML.

title (requerido)

Formato: Texto UTF-8.

Descripción: Este texto será utilizado como título del e-book.

url (requerido)

Formato: Un URI de tipo http.

Descripción: Es la dirección de la página web de donde se extrajo el contenido. Debe apuntar al mismo dominio y directorios en los que se originó el POST.

lang

Valores válidos: es, en (valor por defecto), ca.

Descripción: Es el idioma de los textos provistos por dotEPUB. Actualmente, sólo están contemplados el castellano, el inglés y el catalán.

author

Formato: Texto UTF-8.

Descripción: Es el nombre opcional del autor del e-book, que será mostrado en la cubierta e incluido en los metadatos del libro.

copy

Formato: Texto UTF-8.

Descripción: Es un aviso de copyright opcional que será mostrado en la cubierta del e-book.

format

Valores válidos: epub (valor por defecto), mobi

Descripción: Es el formato del e-book resultante. Por defecto (formato no especificado o valor incorrecto), se producirá un e-book EPUB. Usa mobi para solicitar un e-book en formato MOBI.

Respuesta
En caso de éxito, se enviará un e-book. Dependiendo del formato especificado, el e-book será un archivo EPUB (para e-readers compatibles con EPUB como el Sony Reader, el Nook, el Kobo eReader o iBooks de Apple) o un archivo MOBI (para Amazon Kindle). En caso de error, se retornará un documento XML con la siguiente estructura:
<Errors>
   <Error>
      <Code>WMethod</Code>
      <Message xml:lang="es">
         Método incorrecto: sólo POST es aceptado.
      </Message>
   </Error>
</Errors>
Códigos de error:
  • WMethod: Método incorrecto: sólo POST es aceptado.
  • WURL: Dirección de página web incorrecta.
  • CBig: Contenido demasiado grande.
  • Missing: Una información requerida ({nombre del parámetro}) no se proporcionó o no pudo ser recuperada.
  • Unknown: Error desconocido.

Renuncia

Este software se distribuye «TAL CUAL», SIN GARANTÍAS O CONDICIONES DE NINGÚN TIPO, ya sean expresas o implícitas.