APEX API DOCS v1
Mis Tokens

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.

Base URL: https://apexfichajes.com/api/v1
Disponible 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
curl https://apexfichajes.com/api/v1/players \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Accept: application/json"
Seguridad: Nunca expongas tu token en el frontend. Úsalo solo desde tu backend o serverless function.

Tiers de acceso

FeatureClub ProClub ÉliteEnterprise
GET endpoints (lectura)
POST/PUT (escritura)
Webhooks salientes
Rate limit / minuto603001000+
Tokens simultáneos25

Rate Limiting

Cada respuesta incluye headers que indican tu cuota:

response headers
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ódigoSignificado
200OK — petición exitosa
201Created — recurso creado
400Bad Request — parámetros inválidos
401Unauthorized — token faltante o inválido
403Forbidden — tu plan no tiene acceso a este endpoint
404Not Found — recurso no existe
429Too Many Requests — rate limit excedido
500Internal Server Error — contacta soporte

Listar jugadores

GEThttps://apexfichajes.com/api/v1/players

Devuelve lista paginada de jugadores activos en el directorio Apex.

Query params

ParamTipoDescripción
pageintPágina (default 1)
limitintResultados por página (max 100, default 20)
posicionstringFiltro por posición (ej: "Delantero")
paisstringPaís nacionalidad
edad_minintEdad mínima
edad_maxintEdad máxima
verificadosboolSolo verificados (talento o élite)
request
curl "https://apexfichajes.com/api/v1/players?posicion=Delantero&edad_max=23&limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN"
response 200
{
  "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

GEThttps://apexfichajes.com/api/v1/players/:id

Ficha completa de un jugador específico con todos los campos.

curl
curl https://apexfichajes.com/api/v1/players/12 -H "Authorization: Bearer YOUR_TOKEN"

Mis favoritos

GEThttps://apexfichajes.com/api/v1/me/favorites

Lista de jugadores que tu cuenta tiene marcados como favoritos.

Agregar favorito

POSThttps://apexfichajes.com/api/v1/me/favorites

Marca un jugador como favorito. Solo Club Élite y Enterprise.

request
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"}'

Mis estadísticas

GEThttps://apexfichajes.com/api/v1/me/stats

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.

payload entrante
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

EventoCuándo se dispara
player.createdNuevo jugador aprobado en directorio
player.favoritedAlguien marcó tu jugador como favorito
player.viewedVisita al perfil (con throttle 1/hora/IP)
message.receivedMensaje nuevo a tu equipo
invitation.openedClub abrió tu invitación shortlist
subscription.expiringPlan 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