Tu Mensajero

Tu Mensajero API

Automatiza pedidos sin perder el control.

Integra la creación y consulta de mensajerías de Tu Mensajero en tus propias plataformas. El acceso inicial es gratuito y está diseñado para clientes que necesitan automatizar solicitudes.

Base URL

https://tu-mensajero-backend.onrender.com/api/v1/public/v1

La API no asigna mensajeros automáticamente en el plan inicial. El cliente selecciona al mensajero desde la aplicación.

Primeros pasos

Una integración clara y controlada

Las API keys pertenecen a una cuenta cliente. No compartas contraseñas de usuarios ni tokens de sesión.

01

Crea una key

Solicita una credencial desde tu cuenta cliente y guárdala inmediatamente.

02

Envía la credencial

Usa Authorization: Bearer tm_live_... en cada petición.

03

Protege y revoca

Guarda la key en variables de entorno y revócala si se filtra.

Autenticación

API key en cada petición

La key completa se muestra una sola vez al crearla. El servidor almacena únicamente un hash.

curl -X GET \
  https://tu-mensajero-backend.onrender.com/api/v1/public/v1/requests \
  -H "Authorization: Bearer tm_live_TU_API_KEY"

Nunca incluyas la API key en una aplicación móvil, en JavaScript del navegador, en capturas de pantalla ni en un repositorio público. Utilízala desde el servidor de tu integración.

Credenciales

Crear y administrar API keys

La administración de credenciales requiere una sesión normal de una cuenta cliente. La API key resultante se usa solo en la API pública.

curl -X POST \
  https://tu-mensajero-backend.onrender.com/api/v1/users/me/api-keys \
  -H "Authorization: Bearer TU_TOKEN_DE_USUARIO" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Integración de pedidos" }'
POST /api/v1/users/me/api-keys

Crea una key y muestra el secreto una sola vez.

GET /api/v1/users/me/api-keys

Lista prefijos, scopes, uso y estado. Nunca devuelve secretos.

DELETE /api/v1/users/me/api-keys/{id}

Revoca inmediatamente una credencial.

Endpoints

Recursos disponibles

Todas las respuestas utilizan el formato estándar de la API de Tu Mensajero.

POST
/requests

Crear una solicitud

requests:create
GET
/requests

Listar solicitudes propias

requests:read
GET
/requests/{id}

Consultar una solicitud propia

requests:read
PUT
/requests/{id}

Actualizar antes de asignar

requests:update
DELETE
/requests/{id}

Cancelar una solicitud propia

requests:cancel
GET
/requests/{id}/applicants

Consultar postulantes

applicants:read

Crear una solicitud

POST /requests

El título, la recogida y la entrega son obligatorios.

curl -X POST \
  https://tu-mensajero-backend.onrender.com/api/v1/public/v1/requests \
  -H "Authorization: Bearer tm_live_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-123" \
  -d '{
    "title": "Entregar documentos",
    "pickupAddr": {
      "street": "Calle 23",
      "municipality": "Plaza de la Revolución",
      "province": "La Habana"
    },
    "deliveryAddr": {
      "street": "Calle Reina",
      "municipality": "Centro Habana",
      "province": "La Habana"
    },
    "priceCup": 500
  }'

Estados

Flujo de una solicitud

La API devuelve el estado actual, pero no sustituye la selección humana del mensajero.

PUBLISHEDVisible para mensajeros y acepta postulaciones.
ASSIGNEDEl cliente seleccionó un mensajero.
IN_TRANSITEl mensajero recogió el paquete.
DELIVEREDLa entrega fue completada y calificada.
CANCELEDLa solicitud fue cancelada.

Límites actuales

Plan gratuito inicial

Estos límites protegen la estabilidad de la plataforma y pueden ajustarse según el uso real.

  • 60 peticiones por minuto y por API key.
  • 100 solicitudes creadas por día.
  • Máximo de cinco API keys activas por cuenta.
  • Paginación máxima de 50 elementos.
  • Autoasignación no disponible inicialmente.
  • Webhooks y planes comerciales quedan para una etapa posterior.