API REST

Documentación API

Integra los servicios de Trabajando Juntos en tus aplicaciones. Accede al marketplace, comunidades, eventos y más.

Base URL

https://trabajando-juntos.com/api

Autenticación

Todas las peticiones autenticadas requieren un JWT Bearer token en el header Authorization.

// 1. Obtén token con login
POST /api/auth/login
{ "email": "...", "password": "..." }

// 2. Usa en todas las peticiones
Authorization: Bearer <access_token>

// 3. Renueva cuando expire (24h)
POST /api/auth/refresh
{ "refreshToken": "..." }

Límites de Uso

1,000

req/hora

10,000

req/día

5 MB

max body

Flujo de Escrow

ESCROW_HELD → IN_PROGRESS → DELIVERED → COMPLETED
     ↓                              ↓
  CANCELLED                      DISPUTED

Comisión plataforma: 8% del monto total

Códigos de Error

400Bad Request — Datos inválidos

401Unauthorized — Token faltante o expirado

403Forbidden — Sin permisos

404Not Found — Recurso no encontrado

429Rate Limited — Demasiadas peticiones

500Internal Error — Error del servidor

Ejemplo Completo

cURL

curl -X POST "https://trabajando-juntos.com/api/orders" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"listingId": "clx...", "amount": 500, "message": "Necesito diseño web"}'

JavaScript (fetch)

const res = await fetch('https://trabajando-juntos.com/api/orders', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + token,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    listingId: 'clx...',
    amount: 500,
    message: 'Necesito diseño web'
  }),
});
const data = await res.json();
console.log(data); // { data: { id: '...', status: 'ESCROW_HELD' } }

Plan Empresarial recomendado

Para uso avanzado de la API, el plan Empresarial incluye límites más altos y soporte dedicado.Ver planes →