API de req para integraciones

Consulta el contrato vigente

OpenAPI describe los campos admitidos, permisos, parámetros y respuestas. Los ejemplos de la documentación no contienen credenciales.

• Abrir OpenAPI
• Catálogo MCP

Consulta el contexto con tu clave

Configura REQ_API_KEY en el entorno que ejecuta tu integración. No la envíes desde una página pública. Este ejemplo de terminal requiere una clave real de tu cuenta.

curl "https://req.center/api/v1/context" \
  -H "Authorization: Bearer $REQ_API_KEY"

Selecciona el proyecto y el flujo antes de escribir

Consulta los proyectos y flujos de tu cuenta. Usa project_id y flow_id donde el contrato los admita. Las mutaciones del grafo exigen If-Match con la revisión vigente; una revisión anterior devuelve 409. En MCP ese parámetro se llama revision.

Crea invitaciones individuales

POST /api/v1/requests acepta el nodo, el encargo, cantidad, unidad y destinatarios. En price_only el formulario se incluye y congela con sus valores resueltos; variables pendientes bloquean compartirlo. Fecha y destino son opcionales y pueden acordarse con el proveedor. En recipients puedes usar producer_id del directorio privado o name y contact reales obtenidos del directorio o indicados por el usuario. searchSupplierDirectory devuelve recipient para reutilizarlo. include_form copia los campos del nodo después de validar los datos obligatorios. Envía Idempotency-Key y conserva cada URL de links al recibirla: solo se muestra al crear o reemplazar las invitaciones.

Directorio investigado y empresas publicadas

Las operaciones textile permiten consultar servicios y registros de proveedores investigados con sus fuentes y datos pendientes. Las operaciones business-directory consultan catálogos que las empresas han publicado. Un registro de investigación no acredita disponibilidad ni identidad. Los precios, cuando existan, deben leerse con su unidad, impuestos y condiciones.

Respuestas y límites

Las solicitudes reciben proformas, consultas o negativas. Sus ofertas se consultan con la autorización del propietario. Las claves no administran otras claves ni envían mensajes. Respeta los errores de validación y Retry-After en un 429. Nunca reintentes una mutación cambiando de identidad o descartando el control de revisiones.