Servei de Dades
Preu
Basic |
Temporada en curs |
100 peticions/dia |
€25,00 mensualment |
|
Extra |
Temporada en curs |
1.000 peticions/dia |
€95,00 mensualment |
|
Premium |
Totes |
10.000 peticions/dia |
€575,00 mensualment |
La subscripció mensual es pot cancel·lar en qualsevol moment des del seu compte de Stripe o enviant un mail a bdfutbol@gmail.com indicant el seu nom d'usuari o correu electrònic.
Si prefereix un pressupost a mida contacti amb nosaltres per correu bdfutbol@gmail.com o mitjançant el formulari de contacte
URL principal de l'API
La URL base de l'API és https://photoapi.bdfutbol.com
Autenticació
Totes les sol·licituds de l'API requereixen autenticació mitjançant un token bearer. Per obtenir un token, has d'iniciar sessió utilitzant el punt d'accés /login.
Punt d'accés d'inici de sessió
POST /login
Cos de la sol·licitud:
{
"email": "test@example.com",
"password": "password123"
}
Resposta:
{
"message": "Login successful",
"token": "token"
}
Ús
Un cop autenticat, inclou el token a la capçalera Authorization de les teves sol·licituds:
Authorization: Bearer token
Obtenir foto
El punt d'accés /photos permet recuperar fotos de jugadors utilitzant diferents paràmetres de cerca. Depenent de l'especificitat dels paràmetres proporcionats, la resposta pot contenir un únic fitxer de foto o una llista de fotos candidates.
Opcions de cerca
Pots sol·licitar una foto de les maneres següents:
- Per ID del jugador
- Per criteris de cerca (tots opcionals):
- ID del jugador
- Nom del jugador
- ID de l'equip
- Nom de l'equip
- Número de dorsal
- Per ID de la foto
- Si els paràmetres identifiquen de manera única un sol jugador, la resposta retornarà el seu fitxer de foto.
- Si diversos jugadors coincideixen amb els paràmetres proporcionats (per exemple, diversos jugadors anomenats 'Smith'), la resposta contindrà una llista de candidats, cadascun amb un
photoIdúnic. Pots utilitzar aquest ID per fer una altra sol·licitud per a una foto específica.
Punt d'accés de fotos
POST /photos
Cos de la sol·licitud:
{
"personId": "123",
"name": "Messi",
"season": "2023-24",
"team": "Barcelona",
"teamId": "1",
"number": "10",
"photoId": "9876"
}
Resposta d'una sola foto
Si es troba una coincidència única, l'API respon directament amb el fitxer de la foto.
[Fitxer de foto binari]
Resposta amb múltiples candidats
Si es troben múltiples coincidències, la resposta contindrà una llista de possibles fotos:
{
"photos": [
{
"photoId": "9876",
"season": "2023-24",
"team": "Barcelona"
}
]
}
Utilitza el photoId de la resposta per fer una altra sol·licitud i obtenir una foto específica.
Notes
- Assegura't d'incloure el token
Authorization a la capçalera de totes les sol·licituds.
- En proporcionar criteris de cerca, com més específics siguin els paràmetres, més probabilitats hi ha d'obtenir un únic resultat.
- L'API segueix els principis RESTful i totes les respostes compleixen els codis d'estat HTTP estàndard:
200 OK – Sol·licitud amb èxit400 Bad Request – Paràmetres de sol·licitud no vàlids401 Unauthorized – Token absent o no vàlid404 Not Found – No s'ha trobat cap foto coincident500 Internal Server Error – Error inesperat
Authorization a la capçalera de totes les sol·licituds.200 OK– Sol·licitud amb èxit400 Bad Request– Paràmetres de sol·licitud no vàlids401 Unauthorized– Token absent o no vàlid404 Not Found– No s'ha trobat cap foto coincident500 Internal Server Error– Error inesperat