API

José Henrique Pinheiro Sampaio — Thu, 21 Aug 2025 11:34:28 +0000

O que é uma API?

Uma API (sigla para Application Programming interface) é um conjunto de regras, padrões e ferramentas que permite que diferentes softwares se comuniquem entre si, ela funciona como ponte entre os sistemas e também define como os programas podem trocar informações e quais recursos estão disponíveis para uso, como exemplo podemos usar um restaurante, você é o cliente, a cozinha é o sistema que prepara os pratos (lógica interna) e o garçom é a API, que leva seu pedido até a cozinha e trás a comida pronta

Métodos HTTP e status code

Uma API web funciona usando requisições HTTP, e dentro delas entram dois pontos principais: os métodos e os status codes. Os métodos HTTP são verbos que dizem ao servidor o que queremos fazer com um recurso. Por exemplo, o GET serve para buscar informações, o POST cria algo novo, o PUT atualiza um recurso inteiro, o PATCH atualiza apenas uma parte dele e o DELETE remove. Já os status codes são as respostas que o servidor envia depois de receber a requisição, e eles indicam se deu certo ou se houve algum problema. Quando tudo funciona, podemos receber um 200 OK (requisição bem-sucedida), um 201 Created (quando algo foi criado com sucesso) ou um 204 No Content (quando deu certo, mas não há nada para devolver, como em um DELETE), 404 Not Found (quando o recurso não existe) e etc. Assim, os métodos dizem o que você quer fazer e os status codes dizem como o servidor respondeu.

Como criar uma API com expressJS

Para criar uma API com Express.js, você precisa ter o Node.js instalado. O Express é um framework para Node que facilita muito a criação de servidores e rotas. Um exemplo passo a passo:

No terminal:

mkdir minha-api
cd minha-api
npm init -y
npm install express

Criar o arquivo principal

Crie um arquivo chamado server.js (ou index.js) e coloque o seguinte código:

const express = require("express");
const app = express();
const port = 3000;

app.use(express.json());

app.get("/users", (req, res) => {
res.status(200).json([
{ id: 1, nome: "Ana" },
{ id: 2, nome: "João" }
]);
});

app.post("/users", (req, res) => {
const novoUsuario = req.body;
res.status(201).json({ mensagem: "Usuário criado", usuario: novoUsuario });
});

app.put("/users/:id", (req, res) => {
const { id } = req.params;
const dados = req.body;
res.status(200).json({ mensagem: Usuário ${id} atualizado, dados });
});

app.delete("/users/:id", (req, res) => {
const { id } = req.params;
res.status(204).send();
});

app.listen(port, () => {
console.log(🚀 Servidor rodando em http://localhost:${port});
});

No terminal:

node server.js

Agora sua API estará rodando em http://localhost:3000.

Programação Orientada a Objeto

José Henrique Pinheiro Sampaio — Wed, 20 Aug 2025 12:38:39 +0000

A Programação Orientada a Objeto (POO) é um dos modelos mais utilizados para o desenvolvimento de softwares na atualidade. Ela ajuda a organizar o código de forma que aproxime a lógica da programação do mundo real. As classes fundamentais de POO são: classes, métodos, atributos, objetos, herança e encapsulamento.

Na POO tudo gira em torno de objetos, que são instâncias de classes.

As classes são como plantas arquitetônicas, um molde que define as características e comportamentos do objeto.

Já atributos são informações (ou propriedades) que o objeto possui.

Os métodos são as ações que o objeto pode executar.

Exemplo de todos juntos:

class Carro:
def init(self, cor, modelo):
self.cor = cor
self.modelo = modelo

def acelerar(self):
    print(f"O {self.modelo} está acelerando!")

meu_carro = Carro("vermelho", "Fiat Uno")
meu_carro.acelerar()

Nesse exemplo, Carro é a classe, cor e modelo são atributos, e acelerar() é um método.

Encapsulamento

O encapsulamento é o princípio da POO que consiste em proteger os dados de um objeto, permitindo o acesso de forma controlada. Isso evita que informações sejam manipuladas de maneira indesejada.

Na prática é assim, como exemplo de saldo:

saldo: Público

_saldo: Protegido por convenção (um underline)

__saldo: Protegido com name mangling (dois underlines)

Sem underline o saldo é público, com apenas um é protegido mas não totalmente, e com dois é o mais protegido.

Na prática de um saldo totalmente protegido, ficaria assim:

class ContaBancaria:
def init(self, saldo):
self.__saldo = saldo

def depositar(self, valor):
    self.__saldo += valor

def get_saldo(self):
    return self.__saldo

conta = ContaBancaria(1000)

print(conta.get_saldo())
print(conta.ContaBancaria_saldo)

É importante lembrar que __saldo não é 100% privado, mas fica protegido contra acessos acidentais.
Ou seja, o encapsulamento em Python é mais uma convenção do que uma proibição absoluta.

Herança

A herança nada mais é do que uma classe que herda atributos ou métodos de outra, facilitando a reutilização de código e criando hierarquias de classes.

Exemplo:

class Animal:
def falar(self):
print("O animal fez um som.")

class Cachorro(Animal):
def falar(self):
print("O cachorro latiu: Au au!")

class Gato(Animal):
def falar(self):
print("O gato miou: Miau!")

dog = Cachorro()
cat = Gato()

dog.falar()
cat.falar()

Nesse exemplo, tanto Cachorro quanto Gato herdaram da classe Animal, mas cada um sobrescreveu o método falar() com seu próprio comportamento.

Conclusão

A Programação Orientada a Objeto é o pilar da programação moderna e está presente em linguagens como Python, C++ e muitas outras.

Em resumo:

Classe: Organiza os objetos

Encapsulamento: Protege os dados

Herança: Facilita a reutilização de código

DEV Community: José Henrique Pinheiro Sampaio