Ir al contenido
DocInfra

API de reescritura de documentosBeta

Reescribe documentos por API, no a mano.

El mismo pipeline de jobs que convierte documentos también los reescribe: sube un DOCX, elige el registro, recibe un webhook, descarga el resultado. Para productos que generan o procesan documentos en volumen.

Implementado y en beta: jobs asíncronos de reescritura de DOCX, disponibles para cualquier workspace con esta capacidad habilitada.

Empieza gratisPruébalo gratis

# Encola un job de reescritura de documento

curl -X POST https://api.apidocinfra.com/v1/documents/rewrite \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: rewrite_123" \
  -F "[email protected]" \
  -F "mode=professional" \
  -F "protected_terms=DocInfra, ISO 27001"
# 202 {"job_id": "...", "status": "queued"}; GET /v1/jobs/{job_id} returns the DOCX download_url

Endpoints y campos reales del contrato de la API. Sustituye la key y el archivo.

Diseñada como API

  • Un endpoint

    POST /v1/documents/rewrite recibe el archivo y las mismas opciones que el endpoint de texto: mode, intensity, language, preserve, protected_terms.

  • Asíncrona con webhooks

    202 con un job; eventos document.completed, document.failed y document.rejected firmados con tu secreto.

  • Idempotente

    Mismo archivo y opciones con la misma Idempotency-Key devuelven el mismo job. Otras opciones con la misma key son un 409.

  • Medida

    Las palabras reescritas cuentan en GET /v1/usage bajo document_rewrite, aparte de las reescrituras de texto y las conversiones.

  • Falla de forma segura

    Si un elemento protegido no sobrevive, el job falla con PRESERVATION_FAILED y no se entrega nada.

  • Las mismas garantías que la API de texto

    Prompt versionado, comprobaciones de salida, texto no almacenado, proveedor detrás de una abstracción.

Integración en tres llamadas

  1. 1

    Subida: POST multipart con file, opciones y una Idempotency-Key. Guarda el job_id.

  2. 2

    Espera: consulta GET /v1/jobs/{job_id} o atiende el webhook firmado.

  3. 3

    Descarga: sigue download_url en menos de cinco minutos; pide uno nuevo al job cuando quieras antes de que el documento expire.

Las salidas se juzgan por naturalidad y hechos conservados, no por detectores de IA.

Preguntas

¿Qué formatos?
DOCX de entrada, DOCX de salida. La reescritura de HTML y PDF no está disponible.
¿Cuáles son los límites?
25 MB por archivo, 30.000 palabras reescribibles por documento, más las cuotas del plan y del día del workspace.
¿Qué pasa con el archivo?
Original y resultado quedan en almacenamiento privado 24 horas y después se borran. El texto nunca se registra.