po_sk_ Servidor a Servidor Clave secreta
- Acceso completo dentro del marco de la cuenta
- Nunca entregar en código del navegador
- Sin necesidad de encabezado Origin
- Bloqueado para MCP
Autenticación y claves
Un token Bearer. Cada punto final.
Cada punto final del producto PaperOffice-API espera el encabezado Authorization: Bearer. Sin flujo OAuth, sin actualización.
Dos tipos de token, diez ámbitos de autorización, límites de frecuencia documentados.
Un encabezado Sin flujo OAuth Revocable en cualquier momento
- Infraestructura propia de la UE Sus datos permanecen en Europa.
- ISO 27001 activo Seguridad certificada.
- SOC 2 Tipo II activo Estándares de auditoría internacionales.
- +24 años de experiencia Comprobado. Estable. Seguro para el futuro.
curl -X POST "https://api.paperoffice.ai/latest/job/add/workflow" \ -H "Authorization: Bearer po_ut_YOUR_API_KEY" \ -F "[email protected]" \ -F "idp_collection=invoice" \ -F "model=basic-pro-max"import requestsresponse = requests.post( "https://api.paperoffice.ai/latest/job/add/workflow", headers={"Authorization": "Bearer po_ut_YOUR_API_KEY"}, files={"file_1": open("invoice.pdf", "rb")}, data={"idp_collection": "invoice", "model": "basic-pro-max"},)print(response.json())const form = new FormData();form.append("file_1", new Blob([await readFile("invoice.pdf")]), "invoice.pdf");form.append("idp_collection", "invoice");form.append("model", "basic-pro-max");const response = await fetch("https://api.paperoffice.ai/latest/job/add/workflow", { method: "POST", headers: { Authorization: "Bearer po_ut_YOUR_API_KEY" }, body: form,});console.log(await response.json());Primera llamada
Establecer encabezado, elegir pipeline, enviar
La ruta hacia /latest/job/add/ es el nombre del trabajo de cola: generalmente en la forma handler___command (por ejemplo, paperoffice_aiocr___generate); para IDP estructurado, se utiliza el workflow propio de la pipeline.
- Un encabezado
Authorization: Bearer po_ut_… — un punto final de producto no necesita más. po_sk_ y po_ut_ no envían el encabezado Origin.
- Pipeline en la ruta
handler___command con tres guiones bajos; workflow es la excepción con su propio slug. La notación de puntos responde a API con HTTP 400 JOB_CONFIG_INVALID.
- Resultado o job_id
client_wait es true por defecto: API mantiene la conexión y entrega el resultado en línea. Si el intervalo de tiempo no es suficiente, se devuelve HTTP 202 con job_id y poll_url para GET /latest/job/get/{job_id}.
Para idp_collection=invoice, basic-pro-max es el modelo recomendado: OCR-first limita las colecciones impresas con posiciones de todos modos a basic-pro-max; un model=premium enviado se devuelve como model: basic-pro-max.
Tipos de token
Dos tipos de tokens, claramente separados
Ambos deben enviarse al servidor. Se crean, rotan y revocan en la aplicación bajo Cuenta → API.
po_ut_ Relacionado con el usuario User Token
- Limitable a áreas individuales
- Nunca entregar en código del navegador
- No se requiere encabezado de origen
- Aprobado para MCP
Las llamadas directas desde el navegador no pasan por estos dos tokens, sino por la clave publicable po_pk_, vinculada al origen, con límite de presupuesto y tasa. Ver claves publicables
Permisos
Diez áreas por token de usuario
Un token de usuario contiene exactamente las áreas que usted le asigna al crearlo. Si falta el área, la respuesta será API con HTTP 403.
- Documentos
documentosSubir, Descargar, Procesamiento
- Workspaces
espacios_de_trabajoGestionar carpetas y estructura
- Trabajos de IA
trabajos_aiOCR, IDP, Extracción
- Facturación
facturaciónLeer uso y saldo de la cuenta
- Usuarios
usuariosGestionar miembros del equipo
- Webhooks
webhooksEmpfangen von Ereignissen
- Wissensdatenbank
base_conocimientoBase de conocimientos y preguntas frecuentes
- Agentes
agentesConfigurar agentes IDP
- Flujos de trabajo
flujos_de_trabajoCrear automatizaciones
- Cumplimiento normativo
cumplimientoAuditoría, RGPD, archivado
Límites de frecuencia
Lo que cuenta API
Se cobra por token; sin Bearer por dirección IP. Los siguientes valores son los mínimos documentados que aplican en cada tarifa.
- 5
- Solicitudes por segundo
- 30
- Solicitudes por minuto
- 100
- Solicitudes por hora
- 500
- Solicitudes por día
- Los valores restantes se encuentran en el encabezado de respuesta
Los encabezados RateLimit-* y X-RateLimit-* de cada respuesta indican cuánto queda disponible en la ventana actual.
- Exceso: HTTP 429
La API responde con RATE_LIMIT_EXCEEDED. Repita la llamada después del tiempo indicado en el encabezado Retry-After.
- Las tarifas superiores aumentan los valores
Las tarifas pagadas están por encima de estos valores mínimos. Qué plan tiene qué alcance se indica en la página de precios.
Seguridad
Qué protege una clave
Seis mecanismos que entran en acción durante la operación, cada uno con un código de estado verificable o una ubicación en la aplicación.
- Rotación y revocación
Las claves se crean, listan, rotan y revocan en la aplicación bajo Cuenta → API. Un token revocado responde con HTTP 401 TOKEN_NOT_FOUND.
- Vencimiento y validez
Los tokens vencidos o erróneos devuelven HTTP 401 INVALID_TOKEN. Las claves publicables caducan como máximo a los 365 días.
- Límites por token
Los límites de velocidad se cuentan por token, no por cuenta. Una clave comprometida no afecta a toda la operación.
- Vinculación del origen en el navegador
Las claves publicables requieren un Origin en la lista permitida con cada solicitud; de lo contrario, la API responde con 403 ORIGIN_HEADER_REQUIRED o DOMAIN_NOT_ALLOWED.
- Rastrear el uso
Cada respuesta facturada incluye un bloque _billing; la evaluación por llamada proporciona GET /latest/billing/usage-detail.
- Bloqueos estrictos
El inicio de sesión de cuenta, la gestión de claves, OAuth, el administrador de socios, la mutación de pagos y el crackeo de contraseñas están bloqueados para las claves del navegador. Se permiten los productos APIs, incluida la lectura de facturación y los webhooks. La eliminación de Workspace, el vaciado del papelera y la liberación de retención legal solo se pueden realizar en la aplicación (403 UI_ONLY_ENDPOINT).
Vídeo
Autenticación en acción
Vea cómo funciona una llamada con token Bearer en la práctica — en el vídeo.
Más información
Lo que está al lado
Las páginas que cubren todo lo relacionado con la autenticación operativa.
Publishable Keys Llamadas directamente desde el navegador con po_pk_. Webhooks Recibir eventos en lugar de sondear. Postman-Colección Todos los puntos finales para navegar. API-Catálogo Qué punto final realiza qué trabajo. llms-full.txt Toda la documentación para su IDE. Tarifas Qué alcance cubre cada tarifa.
Comenzar
Crear clave, configurar encabezado, enviar
Puede crear la clave en la aplicación bajo Cuenta → API. La primera llamada se describe paso a paso en la Primera llamada API.
Operaciones y confianza
Lo que los equipos empresariales verifican antes de la primera llamada
Contratos, seguridad, soporte y límites, todos enlazados en un solo lugar.
- Seguridad y Cumplimiento ISO 27001, SOC 2 Tipo II, infraestructura propia en la UE.
- SLA del 99,9 % Disponibilidad por mes calendario, garantizada contractualmente.
- Procesamiento de datos por encargo (DPA) Contrato conforme al RGPD para el procesamiento de datos por encargo.
- Lista de subprocesadores Todos los subcontratistas, listados de forma transparente.
- Soporte técnico Vía directa al equipo de soporte, con ticket.
- Límites de velocidad y encabezados Valores mínimos documentados por token, encabezado de límite de velocidad en cada respuesta.
- Precios y créditos Precios transparentes de créditos por llamada.
Siguiente parada
Así es como continúa
El siguiente paso recomendado en el embudo de desarrolladores y dos ramificaciones adecuadas.
