2024-25	2014-15	2004-05	1994-95	1984-85	1974-75	1964-65	1954-55	1944-45	1934-35
2023-24	2013-14	2003-04	1993-94	1983-84	1973-74	1963-64	1953-54	1943-44	1933-34
2022-23	2012-13	2002-03	1992-93	1982-83	1972-73	1962-63	1952-53	1942-43	1932-33
2021-22	2011-12	2001-02	1991-92	1981-82	1971-72	1961-62	1951-52	1941-42	1931-32
2020-21	2010-11	2000-01	1990-91	1980-81	1970-71	1960-61	1950-51	1940-41	1930-31
2019-20	2009-10	1999-00	1989-90	1979-80	1969-70	1959-60	1949-50	1939-40	1929-30
2018-19	2008-09	1998-99	1988-89	1978-79	1968-69	1958-59	1948-49		1928-29
2017-18	2007-08	1997-98	1987-88	1977-78	1967-68	1957-58	1947-48
2016-17	2006-07	1996-97	1986-87	1976-77	1966-67	1956-57	1946-47
2015-16	2005-06	1995-96	1985-86	1975-76	1965-66	1955-56	1945-46	1935-36

2024-25	2014-15	2004-05	1994-95	1984-85	1974-75	1964-65 1 2	1954-55 1 2	1944-45	1934-35 1 2 3
2023-24	2013-14	2003-04	1993-94	1983-84	1973-74	1963-64 1 2	1953-54 1 2	1943-44	1933-34
2022-23	2012-13	2002-03	1992-93	1982-83	1972-73	1962-63 1 2	1952-53 1 2	1942-43 1 2 3	1932-33
2021-22	2011-12	2001-02	1991-92	1981-82	1971-72	1961-62 1 2	1951-52 1 2	1941-42 1 2 3	1931-32
2020-21	2010-11	2000-01	1990-91	1980-81	1970-71	1960-61 1 2	1950-51 1 2	1940-41 1 2	1930-31
2019-20	2009-10	1999-00	1989-90	1979-80	1969-70	1959-60 1 2	1949-50 1 2	1939-40 1 2 3 4 5	1929-30
2018-19	2008-09	1998-99	1988-89	1978-79	1968-69	1958-59 1 2	1948-49		1928-29 1 2
2017-18	2007-08	1997-98	1987-88	1977-78	1967-68 1 2	1957-58 1 2	1947-48
2016-17	2006-07	1996-97	1986-87	1976-77	1966-67 1 2	1956-57 1 2	1946-47
2015-16	2005-06	1995-96	1985-86	1975-76	1965-66 1 2	1955-56 1 2	1945-46	1935-36 1 2 3

2024-25 I II III IV V	2014-15 I II III IV	2004-05 I II III IV	1994-95 I II III IV	1984-85 I II
2023-24 I II III IV V	2013-14 I II III IV	2003-04 I II III IV	1993-94 I II III IV	1983-84 I II
2022-23 I II III IV V	2012-13 I II III IV	2002-03 I II III IV	1992-93 I II III IV	1982-83 I II
2021-22 I II III IV V	2011-12 I II III IV	2001-02 I II III IV	1991-92 I II III IV	1981-82 I II
2020-21 I II III IV V	2010-11 I II III IV	2000-01 I II III IV	1990-91 I II III IV	1980-81 I II
2019-20 I II III IV	2009-10 I II III IV	1999-00 I II III IV	1989-90 I II III IV	1979-80 I II
2018-19 I II III IV	2008-09 I II III IV	1998-99 I II III IV	1988-89 I II III IV	1978-79 I II
2017-18 I II III IV	2007-08 I II III IV	1997-98 I II III IV	1987-88 I II III IV	1977-78 I II
2016-17 I II III IV	2006-07 I II III IV	1996-97 I II III IV	1986-87
2015-16 I II III IV	2005-06 I II III IV	1995-96 I II III IV	1985-86 I II

2024-25	2014-15	2004-05	1994-95	1984-85	1974-75
2023-24	2013-14	2003-04	1993-94	1983-84	1973-74
2022-23	2012-13	2002-03	1992-93	1982-83	1972-73
2021-22	2011-12	2001-02	1991-92	1981-82	1971-72
2020-21	2010-11	2000-01	1990-91	1980-81	1970-71
2019-20	2009-10	1999-00	1989-90	1979-80
2018-19	2008-09	1998-99	1988-89	1978-79
2017-18	2007-08	1997-98	1987-88	1977-78
2016-17	2006-07	1996-97	1986-87	1976-77
2015-16	2005-06	1995-96	1985-86	1975-76

2024-25	2014-15	2004-05	1994-95	1984-85	1974-75	1964-65
2023-24	2013-14	2003-04	1993-94	1983-84	1973-74	1963-64
2022-23	2012-13	2002-03	1992-93	1982-83	1972-73
2021-22	2011-12	2001-02	1991-92	1981-82	1971-72
2020-21	2010-11	2000-01	1990-91	1980-81	1970-71
2019-20	2009-10	1999-00	1989-90	1979-80	1969-70
2018-19	2008-09	1998-99	1988-89	1978-79	1968-69
2017-18	2007-08	1997-98	1987-88	1977-78	1967-68
2016-17	2006-07	1996-97	1986-87	1976-77	1966-67
2015-16	2005-06	1995-96	1985-86	1975-76	1965-66

2024-25	2014-15	2004-05	1994-95	1984-85	1974-75	1964-65	1954-55		1934-35
2023-24	2013-14	2003-04	1993-94	1983-84	1973-74	1963-64	1953-54		1933-34
2022-23	2012-13	2002-03	1992-93	1982-83	1972-73	1962-63	1952-53	1942-43	1932-33
2021-22	2011-12	2001-02	1991-92	1981-82	1971-72	1961-62	1951-52	1941-42	1931-32
2020-21	2010-11	2000-01	1990-91	1980-81	1970-71	1960-61	1950-51	1940-41	1930-31
2019-20	2009-10	1999-00	1989-90	1979-80	1969-70	1959-60	1949-50	1939-40	1929-30
2018-19	2008-09	1998-99	1988-89	1978-79	1968-69	1958-59	1948-49	1938-39
2017-18	2007-08	1997-98	1987-88	1977-78	1967-68	1957-58	1947-48	1937-38
2016-17	2006-07	1996-97	1986-87	1976-77	1966-67	1956-57	1946-47	1936-37
2015-16	2005-06	1995-96	1985-86	1975-76	1965-66	1955-56		1935-36

2025	2015	2005
2024	2014	2004
2023	2013	2003
2022	2012	2002
2021	2011	2001
2020	2010
2019	2009
2018	2008
2017	2007
2016	2006

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 èxit
- 400 Bad Request – Paràmetres de sol·licitud no vàlids
- 401 Unauthorized – Token absent o no vàlid
- 404 Not Found – No s'ha trobat cap foto coincident
- 500 Internal Server Error – Error inesperat