API Apex Fichajes
REST API JSON para integrar tu sistema (CRM, scouting interno, dashboard custom) con la base de datos de talento curado de Apex.
https://apexfichajes.com/api/v1Disponible para: Plan Club Pro (lectura) y Club Élite (lectura + escritura + webhooks)
Autenticación
Todas las peticiones requieren un token Bearer en el header. Genera tu token en mi API.
curl https://apexfichajes.com/api/v1/players \ -H "Authorization: Bearer YOUR_TOKEN_HERE" \ -H "Accept: application/json"
Tiers de acceso
| Feature | Club Pro | Club Élite | Enterprise |
|---|---|---|---|
| GET endpoints (lectura) | ✓ | ✓ | ✓ |
| POST/PUT (escritura) | — | ✓ | ✓ |
| Webhooks salientes | — | ✓ | ✓ |
| Rate limit / minuto | 60 | 300 | 1000+ |
| Tokens simultáneos | 2 | 5 | ∞ |
Rate Limiting
Cada respuesta incluye headers que indican tu cuota:
X-RateLimit-Limit: 300 X-RateLimit-Remaining: 287 X-RateLimit-Reset: 1747684200
Si excedes el límite recibes 429 Too Many Requests. Espera al timestamp X-RateLimit-Reset.
Códigos de error
| Código | Significado |
|---|---|
| 200 | OK — petición exitosa |
| 201 | Created — recurso creado |
| 400 | Bad Request — parámetros inválidos |
| 401 | Unauthorized — token faltante o inválido |
| 403 | Forbidden — tu plan no tiene acceso a este endpoint |
| 404 | Not Found — recurso no existe |
| 429 | Too Many Requests — rate limit excedido |
| 500 | Internal Server Error — contacta soporte |
Listar jugadores
Devuelve lista paginada de jugadores activos en el directorio Apex.
Query params
| Param | Tipo | Descripción |
|---|---|---|
| page | int | Página (default 1) |
| limit | int | Resultados por página (max 100, default 20) |
| posicion | string | Filtro por posición (ej: "Delantero") |
| pais | string | País nacionalidad |
| edad_min | int | Edad mínima |
| edad_max | int | Edad máxima |
| verificados | bool | Solo verificados (talento o élite) |
curl "https://apexfichajes.com/api/v1/players?posicion=Delantero&edad_max=23&limit=10" \ -H "Authorization: Bearer YOUR_TOKEN"
{
"ok": true,
"page": 1,
"total": 47,
"data": [
{
"id": 12,
"username": "juanperez",
"posicion": "Delantero Centro",
"edad": 19,
"nacionalidad": "Colombia",
"club_actual": "Once Caldas",
"estatura": 1.85,
"pierna_habil": "derecha",
"verificado": "talento",
"foto_url": "https://res.cloudinary.com/...",
"perfil_url": "https://apexfichajes.com/ver_perfil.php?id=12"
}
]
}
Detalle de jugador
Ficha completa de un jugador específico con todos los campos.
curl https://apexfichajes.com/api/v1/players/12 -H "Authorization: Bearer YOUR_TOKEN"
Mis favoritos
Lista de jugadores que tu cuenta tiene marcados como favoritos.
Agregar favorito
Marca un jugador como favorito. Solo Club Élite y Enterprise.
curl -X POST https://apexfichajes.com/api/v1/me/favorites \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"jugador_id": 12, "nota": "Lo vi vs América, gran control"}'
Búsqueda full-text
Búsqueda por nombre, apellido, club, posición.
curl "https://apexfichajes.com/api/v1/players/search?q=delantero+colombiano+sub20" \ -H "Authorization: Bearer YOUR_TOKEN"
Mis estadísticas
Métricas de tu actividad: vistas, mensajes, invitaciones, conversiones.
Webhooks
Apex puede notificar a tu sistema cuando ocurren eventos. Solo Club Élite y Enterprise.
Configura tus webhooks desde mi_api.php → tab Webhooks (próximamente UI completa). Mientras: solicita por WhatsApp.
POST https://tu-servidor.com/webhook
Headers:
X-Apex-Signature: sha256=...
X-Apex-Event: player.favorited
Body:
{
"event": "player.favorited",
"timestamp": 1747684200,
"data": {
"jugador_id": 12,
"scout_id": 47,
"scout_username": "carlos_scout"
}
}
Eventos disponibles
| Evento | Cuándo se dispara |
|---|---|
| player.created | Nuevo jugador aprobado en directorio |
| player.favorited | Alguien marcó tu jugador como favorito |
| player.viewed | Visita al perfil (con throttle 1/hora/IP) |
| message.received | Mensaje nuevo a tu equipo |
| invitation.opened | Club abrió tu invitación shortlist |
| subscription.expiring | Plan vence en 7/3/1 días |
¿Listo para integrar?
Genera tu token y empieza a sincronizar tu CRM con el catálogo de talento curado más completo de Latam.
Generar mi token
APEX