Cost

The monthly subscription can be canceled at any time through your Stripe account or sending an mail to [email protected] specifying your username or email.

If you prefer a custom budget, please contact us by mail at [email protected] or with the contact form

API Main Url

The base url of the API is https://photoapi.bdfutbol.com

Authentication

All API requests require authentication via a bearer token. To obtain a token, you must log in using the /login endpoint.

Login Endpoint

POST /login

Request Body:

{
    "email": "[email protected]",
    "password": "password123"
}

Response:

{
    "message": "Login successful",
    "token": "token"
}

Usage

Once authenticated, include the token in the Authorization header of your requests:

Authorization: Bearer token

Get Photo

The /photos endpoint allows retrieving player photos using different search parameters. Depending on the specificity of the provided parameters, the response may either return a single photo file or a list of candidate photos.

Search Options

You can request a photo in the following ways:

• By player ID
• By search criteria (all optional):
  • Player ID
  • Player name
  • Team ID
  • Team name
  • Shirt number
• By photo ID

• If the parameters uniquely identify a single player, the response will return its photo file.
• If multiple players match the given parameters (e.g., multiple players named 'Smith'), the response will contain a list of candidates, each with a unique photoId. You can use this ID to make another request for a specific photo.

Photos Endpoint

POST /photos

Request Body:

{
    "personId": "123",
    "name": "Messi",
    "season": "2023-24",
    "team": "Barcelona",
    "teamId": "1",
    "number": "10",
    "photoId": "9876"
}

Single Photo Response

If a unique match is found, the API responds with the photo file directly.

[Binary Photo File]

Multiple Candidates Response

If multiple matches are found, the response will contain a list of possible photos:

{
    "photos": [
        {
            "photoId": "9876",
            "season": "2023-24",
            "team": "Barcelona"
        }
    ]
}

Use the photoId from the response to make another request to obtain a specific photo.

Notes

• Ensure the Authorization token is included in the header for all requests.
• When providing search criteria, more specific parameters increase the chance of retrieving a single result.
• The API follows RESTful principles, and all responses adhere to standard HTTP status codes:
  • 200 OK – Request successful
  • 400 Bad Request – Invalid request parameters
  • 401 Unauthorized – Missing or invalid token
  • 404 Not Found – No matching photo found
  • 500 Internal Server Error – Unexpected error