This guide explains step-by-step how to connect to the Akisplataforma API, what credentials you need, and how to correctly perform queries. The connection flow is based on the OAuth 2.0 standard, which means you must first obtain an access token and then use that token to access data.
What do I need to connect to the API?
In order to use the API you need personal credentials.
- These credentials are available in your user area on the website.
- In the “API” section you will find the information you need to use:
- username : User ID for the API (you'll find it in the API area of your user account).
- password : This is the same password you use to log in to the website.
- client_id : API connection identifier (you will find it in the API area of your user account).
How do I log in?
Now that you have your credentials, you can connect. The connection follows the OAuth 2.0 standard, which is characterized by a two-step process:
- Step 1: Request an access token (authentication).
- Step 2: Consume the API using that token (data query).
You can do this programmatically (JavaScript, Python, PHP, etc.) or using a tool like Postman. (We've attached sample images in a request using Postman.)
Step 1: Request an access token
You must make a POST request to the URL: https://akisplataforma.es/oauth/token with the following content in the request body ( application/json format):{"grant_type": "password","client_id": "TU_CLIENT_ID_API","username": "TU_EMAIL_API","password": "TU_CONTRASEÑA"}
The following image shows how to make the request and the expected response, the important part of the response is the access_token :
Step 2: Perform the data query
Now that you have your token, make a second request to consume any of the API endpoints published at https://akisplataforma.es/api-documentacion , for example, to obtain the data related to the news we should make a query using the get method to the endpoint https://akisplataforma.es/api/news using the token obtained previously.
