Da acceso a la API a un socio
Crea una integración de acceso a API con clave, secreto, permisos, IP permitidas y límite de solicitudes, y deja que los socios reintenten con seguridad.
Actualizado el 13 de octubre de 2026
Una integración de acceso a API da a un socio, a un cliente o a tu propio software sus propias credenciales para usar la API de Transportial. Tú decides exactamente qué puede hacer. Como cada socio recibe una integración independiente, puedes ver su actividad y revocar su acceso sin afectar a nadie más.
Crea el acceso
- Abre el menú lateral (☰, arriba a la derecha), elige Integraciones y haz clic en + Crear integración.
- Introduce un Nombre que indique quién lo usa, por ejemplo «Portal de pedidos del cliente X».
- En Selecciona el tipo de integración, elige Integración de acceso a API.
- En Selecciona los permisos, elige lo que puede hacer el socio, por ejemplo leer y crear órdenes de transporte. Concede solo lo necesario.
- Haz clic en Generar para crear la clave de acceso y la Clave secreta, o introduce las tuyas.
- Si quieres, añade las Direcciones IP del socio. Las llamadas desde otras direcciones se rechazan.
- Si quieres, fija Máximo de solicitudes por minuto para proteger tu plataforma de un uso intensivo.
- Pon Apagado/Encendido en encendido y haz clic en Guardar.
- Comparte la clave de acceso y el secreto con el socio a través de un canal seguro.
Cualquiera que tenga la clave y el secreto puede actuar en tu plataforma dentro de los permisos que elegiste. No los envíes nunca por correo electrónico sin cifrar ni por chat, y genera unos nuevos si crees que se han filtrado.
Cambia o revoca el acceso
- Para cambiar los permisos, abre la integración, haz clic en el lápiz (✎), cambia Selecciona los permisos y haz clic en Guardar.
- Para dar al socio credenciales nuevas, vuelve a hacer clic en Generar y guarda. Las antiguas dejan de funcionar.
- Para detener el acceso temporalmente, pon Apagado/Encendido en apagado y guarda.
- Para detener el acceso definitivamente, haz clic en Eliminar en la fila de la lista de integraciones.
Deja que el socio reintente con seguridad con un Idempotency-Key
Cuando una llamada agota el tiempo de espera, el software del socio no sabe si Transportial ya creó la orden. Para evitar duplicados, puede enviar en sus llamadas de creación un encabezado Idempotency-Key con un valor único, por ejemplo su propio número de orden. Si la misma solicitud vuelve a llegar con la misma clave, Transportial devuelve la primera respuesta en lugar de crear la orden dos veces. Esa respuesta lleva el encabezado Idempotency-Replayed: true.
- La misma clave con otra solicitud se rechaza con el estado 422.
- Una repetición mientras la primera solicitud aún se está procesando recibe el estado 409; el socio vuelve a intentarlo un poco después.
- Solo se recuerdan las respuestas correctas. Si la primera solicitud falló, la misma clave se puede volver a usar.
Esto funciona de forma predeterminada en todas las llamadas de creación. Los administradores pueden cambiarlo para toda la plataforma:
- Abre el menú lateral (☰, arriba a la derecha) y elige Configuración.
- Haz clic en la pestaña Entorno y abre la sección Integraciones.
- En API: reintentos seguros (Idempotency-Key), comprueba que Respetar el encabezado Idempotency-Key está activado.
- Fija Horas que se recuerda una clave (24 de forma predeterminada). Después, una clave se puede volver a usar.
- Si quieres, indica en Operaciones las operaciones de la API que respetan el encabezado, separadas por comas, por ejemplo
create:*, update:trip. Déjalo vacío para todas las operaciones de creación. - Haz clic en Guardar al final de la página.
Indica al socio dónde está la documentación
Los desarrolladores encuentran la documentación de la API en el portal para desarrolladores. Consulta Desarrolla sobre Transportial.