Precio

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 exitosa
  • 400 Bad Request – Parámetros de solicitud no válidos
  • 401 Unauthorized – Token ausente o no válido
  • 404 Not Found – No se encontró ninguna foto coincidente
  • 500 Internal Server Error – Error inesperado