Servicio de Datos
Precio
Basic |
Temporada en curso |
100 peticiones/día |
€25,00 mensualmente |
|
Extra |
Temporada en curso |
1.000 peticiones/día |
€95,00 mensualmente |
|
Premium |
Todas |
10.000 peticiones/día |
€575,00 mensualmente |
La suscripción mensual se puede cancelar en cualquier momento desde su cuenta de Stripe o enviando un mail a bdfutbol@gmail.com indicando su nombre de usuario o correo electrónico.
Si prefiere un presupuesto a medida contacte con nosotros por correo bdfutbol@gmail.com o mediante el formulario de contacto
URL principal de la API
La URL base de la API es https://photoapi.bdfutbol.com
Autenticación
Todas las solicitudes de la API requieren autenticación mediante un token bearer. Para obtener un token, debes iniciar sesión utilizando el endpoint /login.
Endpoint de inicio de sesión
POST /login
Cuerpo de la solicitud:
{
"email": "test@example.com",
"password": "password123"
}
Respuesta:
{
"message": "Login successful",
"token": "token"
}
Uso
Una vez autenticado, incluye el token en la cabecera Authorization de tus solicitudes:
Authorization: Bearer token
Obtener foto
El endpoint /photos permite recuperar fotos de jugadores utilizando diferentes parámetros de búsqueda. Dependiendo de la especificidad de los parámetros proporcionados, la respuesta puede contener un único archivo de foto o una lista de fotos candidatas.
Opciones de búsqueda
Puedes solicitar una foto de las siguientes maneras:
- Por ID del jugador
- Por criterios de búsqueda (todos opcionales):
- ID del jugador
- Nombre del jugador
- ID del equipo
- Nombre del equipo
- Número de dorsal
- Por ID de la foto
- Si los parámetros identifican de manera única a un solo jugador, la respuesta devolverá su archivo de foto.
- Si varios jugadores coinciden con los parámetros proporcionados (por ejemplo, varios jugadores llamados 'Smith'), la respuesta contendrá una lista de candidatos, cada uno con un
photoIdúnico. Puedes usar este ID para hacer otra solicitud y obtener una foto específica.
Endpoint de fotos
POST /photos
Cuerpo de la solicitud:
{
"personId": "123",
"name": "Messi",
"season": "2023-24",
"team": "Barcelona",
"teamId": "1",
"number": "10",
"photoId": "9876"
}
Respuesta de una sola foto
Si se encuentra una coincidencia única, la API responde directamente con el archivo de la foto.
[Archivo de foto binario]
Respuesta con múltiples candidatos
Si se encuentran múltiples coincidencias, la respuesta contendrá una lista de posibles fotos:
{
"photos": [
{
"photoId": "9876",
"season": "2023-24",
"team": "Barcelona"
}
]
}
Utiliza el photoId de la respuesta para hacer otra solicitud y obtener una foto específica.
Notas
- Asegúrate de incluir el token
Authorization en la cabecera de todas las solicitudes.
- Al proporcionar criterios de búsqueda, cuanto más específicos sean los parámetros, mayor será la probabilidad de obtener un único resultado.
- La API sigue los principios RESTful y todas las respuestas cumplen con los códigos de estado HTTP estándar:
200 OK – Solicitud exitosa400 Bad Request – Parámetros de solicitud no válidos401 Unauthorized – Token ausente o no válido404 Not Found – No se encontró ninguna foto coincidente500 Internal Server Error – Error inesperado
Authorization en la cabecera de todas las solicitudes.200 OK– Solicitud exitosa400 Bad Request– Parámetros de solicitud no válidos401 Unauthorized– Token ausente o no válido404 Not Found– No se encontró ninguna foto coincidente500 Internal Server Error– Error inesperado