Introducing the cartrolandofc Public API

The cartrolandofc Public API is a powerful tool that allows developers to access and manipulate data related to the Brazilian soccer championship (Campeonato Brasileiro de Futebol). With this API, you can retrieve information on teams, players, matches, and much more.

To make things even better, the cartrolandofc Public API is entirely open-source and free to use, which means you can start using it right away in your own projects.

In this blog post, we will explore the cartrolandofc API and provide several example code snippets using JavaScript, one of the most popular programming languages for web development.

Getting Started with the cartrolandofc API

Before we dive into the code examples, let's take a quick look at how to get started with the cartrolandofc API.

First, you'll need to create an account on https://api.cartolafc.globo.com/auth/signup, which will provide you with an access token. This access token is required to make any API requests.

Once you have your access token, you can start making API requests to the cartrolandofc server. All endpoints follow the standard REST API conventions, so you should be familiar with the HTTP methods and response codes.

Code Examples

Here are some code examples using JavaScript to get you started with the cartrolandofc API.

Retrieving Team Information

To retrieve information about a specific team, you can use the following example code:

const axios = require('axios');

const accessToken = 'YOUR_ACCESS_TOKEN';
const teamId = 'FLA';

axios.get(`https://api.cartolafc.globo.com/time/slug/${teamId}`, {
    headers: {
        'X-GLB-Token': accessToken,
    },
})
.then((response) => {
    console.log(response.data);
})
.catch((error) => {
    console.error(error);
});

In this example, we use the axios library to make an HTTP GET request to the https://api.cartolafc.globo.com/time/slug/FLA endpoint, which retrieves information about the Flamengo team (identified by the "FLA" slug). We also pass our access token in the "X-GLB-Token" header.

Retrieving Player Information

To retrieve information about a specific player, you can use the following example code:

const axios = require('axios');

const accessToken = 'YOUR_ACCESS_TOKEN';
const playerId = 1234;

axios.get(`https://api.cartolafc.globo.com/atletas/mercado`, {
    headers: {
        'X-GLB-Token': accessToken,
    },
})
.then((response) => {
    const player = response.data.atletas.find((p) => p.id === playerId);
    console.log(player);
})
.catch((error) => {
    console.error(error);
});

In this example, we use the same axios library to make an HTTP GET request to the https://api.cartolafc.globo.com/atletas/mercado endpoint, which retrieves information about all the players in the Brazilian soccer championship. We then use the Array.find() method to look for the player with the given ID (1234), and print the resulting object.

Submitting a Team

To submit a new team to the Brazilian soccer championship, you can use the following example code:

const axios = require('axios');

const accessToken = 'YOUR_ACCESS_TOKEN';
const team = {
    esquema_id: 3,
    time: 'My Team',
    slug: 'my-team',
    nome: 'My Team Name',
    foto_perfil: 'https://my.team/photo.png',
    cartoleiro_pro: false,
    nacionalidade: 'Brazil',
    tipo_escudo: 1,
    cor1: '#FF0000',
    cor2: '#0000FF',
    jogador: [
        { atleta_id: 1234 },
        { atleta_id: 5678 },
    ],
};

axios.post('https://api.cartolafc.globo.com/time/salvar', team, {
    headers: {
        'X-GLB-Token': accessToken,
    },
})
.then((response) => {
    console.log(response.data);
})
.catch((error) => {
    console.error(error);
});

In this example, we use the axios library again to make an HTTP POST request to the https://api.cartolafc.globo.com/time/salvar endpoint, which submits a new team to the Brazilian soccer championship. We pass the team object in the request body, along with our access token in the "X-GLB-Token" header.

Conclusion

In this blog post, we introduced the cartrolandofc Public API and provided several examples of how to use it in JavaScript. With the cartrolandofc API, you can retrieve information about teams, players, and matches in the Brazilian soccer championship, and even submit your own team. This powerful tool is entirely open-source and free to use, so start exploring it today!