APIs REST ou RESTful estão em toda parte hoje em dia. Você pode ter usado mesmo sem saber nada sobre isso.  Neste artigo, falarei sobre APIs REST. Vou discutir como eles funcionam, seus aplicativos e muitos mais. Vamos começar.

Por que USAR REST API:

Em aplicativos da web tradicionais, digamos um servidor da web PHP simples,

• Você solicita uma página (digamos php) do servidor.
• O servidor encontra o arquivo de script (php) correspondente à página solicitada e começa a executá-la. O script se conecta ao banco de dados, procura as informações necessárias, coloca as informações na página de uma forma bem formatada (combinando HTML + CSS + JavaScript com os dados) que parece muito atraente para o visitante.
• Em seguida, o servidor o envia de volta ao visitante.

Neste modelo, todo o processamento é feito no lado do servidor. Portanto, o servidor precisa trabalhar mais. Aqui, os dados não são separados da página, são incorporados profundamente na página.

Se, no futuro, você quiser fazer um aplicativo Android ou iOS ou um aplicativo Desktop do seu site, terá que trabalhar muito mais. Você terá que se conectar ao banco de dados diretamente de cada um desses aplicativos, o que pode não ser muito seguro. O tempo de desenvolvimento aumentará e surgirão problemas de portabilidade.

Digamos que você tenha criado aplicativos para desktop, Android e iOS em seu site. O nome completo do usuário é exibido em letras minúsculas em cada um deles. Agora, você gostaria de mostrá-lo em maiúsculas. Bem, os desenvolvedores precisam modificar a versão Desktop, Android e iOS do seu aplicativo separadamente para fazer isso. O que é demorado. No mundo real, as coisas não serão tão simples como esta. Portanto, uma versão do aplicativo (digamos que a versão Desktop) pode ter um bug sério no processo de atualização. Consertar mais tarde levaria mais tempo. Você pode ver como o tempo de desenvolvimento aumenta? Esta solução também não é portátil.

Na API REST, você pergunta ao servidor API o que você precisa e ele envia apenas as informações solicitadas, nenhuma formatação adicional é feita no servidor. Não há necessidade de processamento desnecessário no servidor. Portanto, o desempenho do seu site e aplicativos é naturalmente aprimorado. Além disso, você pode usar os mesmos dados em seu site, aplicativo de desktop, aplicativos Android e iOS. As alterações feitas nos servidores serão refletidas nos aplicativos que estão usando a API. O tempo e o custo de desenvolvimento do aplicativo também serão reduzidos.

Como a API REST funciona:

As APIs REST têm endpoints. Um endpoint nada mais é do que um URL, mas de uma forma bem formatada e significativa. Ele usa as solicitações HTTP nativas (como OBTER, PUBLICAR, COLOCAR, EXCLUIR etc) para decidir o que fazer quando você acessar cada endpoint. Eu vou falar sobre isso mais tarde.

O formato de saída da API REST é JSON, também conhecido como JavaScript Object Notation.

Um exemplo da saída de um OBTER solicitação para a API REST em / users / id / 12 endpoint pode ter a seguinte aparência:

"id": 12,
"nome": "David Smith",
"idade": 42,
"telefones": ["124-211-2341", "889-211-4545"],
"país": "EUA"

Como você pode ver, eu fiz um OBTER pedido em / users / id / 12 endpoint para dizer à API REST para me dar informações sobre o usuário que tem o eu ia 12. Recebi apenas as informações que solicitei, nada mais, nada menos.

Agora, digamos que você deseja informações sobre os últimos 10 usuários que se inscreveram em seu site. Você pode fazer um OBTER pedido em / users / latest / 10 ponto final.

Você pode adicionar novos dados em seu servidor usando a API REST também. Normalmente, o HTTP PUBLICAR pedido é usado para pedir à API REST para adicionar novos dados ao servidor API.

Por exemplo, você pode fazer um PUBLICAR pedido em /Comercial endpoint com os dados do novo usuário e será adicionado ao banco de dados em seu servidor de API. Você também pode configurar sua API para retornar o status da solicitação.

"statusCode": 400,
"statusText": "Usuário adicionado com sucesso.",
"dados":
"id": 13,
"nome": "Mary Smith",
"idade": 35,
"telefones": ["124-211-2341", "889-211-4545"],
"país": "EUA"

Como você pode ver, o statusCode e statusText propriedade do objeto JSON notifica o cliente API de que o usuário foi adicionado com sucesso. Os dados adicionados são retornados também no dados propriedade do objeto JSON. Você pode configurar sua API da maneira que desejar.

Você também pode atualizar um registro existente do banco de dados do servidor API. O COLOCAR A solicitação HTTP é usada em um endpoint da API para atualizar os dados existentes no banco de dados do seu servidor API.

Por exemplo, digamos que você deseja atualizar o número de telefone do usuário com a id 13. Você pode fazer um COLOCAR solicitação no endpoint da API / user / id / 13.

"statusCode": 200,
"statusText": "Usuário atualizado.",
"old_data":
"id": 13,
"nome": "Mary Smith",
"idade": 35,
"telefones": ["124-211-2341", "889-211-4545"],
"país": "EUA"
,
"novos dados":
"id": 13,
"nome": "Mary Smith",
"idade": 35,
"telefones": ["100-211-1111", "140-211-1145"],
"país": "EUA"

Como você pode ver, a operação de atualização foi bem-sucedida. Os dados antigos e novos são retornados no dados_antigos e novos dados propriedade do objeto JSON respectivamente.

Você também pode excluir dados do banco de dados do servidor API com o protocolo HTTP EXCLUIR solicitação no endpoint da API.

Por exemplo, para excluir o usuário com a id 12, você pode fazer um EXCLUIR solicitação no endpoint da API / user / id / 12.

"statusCode": 150,
"statusText": "Usuário removido.",
"dados":
"id": 12,
"nome": "David Smith",
"idade": 42,
"telefones": ["124-211-2341", "889-211-4545"],
"país": "EUA"

Como você pode ver, o usuário é excluído e os dados do usuário excluídos são retornados no dados propriedade do objeto JSON.

Eu expliquei a maneira padrão de usar o OBTER, PUBLICAR, COLOCAR e EXCLUIR Solicitação HTTP nos endpoints da API para fazer a operação CRUD (Criar, Ler, Atualizar e Excluir) usando a API REST. Mas você pode configurar sua API para fazer certas coisas em certas solicitações HTTP. Nada está consertado aqui. Por exemplo, você pode atualizar a API usando OBTER Solicitação HTTP. Você não tem que usar COLOCAR. Depende do designer da API.

Você também projeta os endpoints da API. Dar nomes significativos aos endpoints da API torna a API REST muito mais fácil de usar.

Aplicativos da API REST:

APIs tornam o desenvolvimento de aplicativos mais fácil e modular. Com a ajuda da API REST, você pode facilmente portar seu aplicativo para diferentes plataformas.

Tudo que você precisa fazer é projetar e desenvolver uma API REST de seu aplicativo. Em seguida, você pode usar a API REST de seu site, aplicativo Android, aplicativo iOS, aplicativo de desktop Windows e aplicativo Linux, etc. Dessa forma, todos os seus aplicativos em plataformas diferentes usarão a mesma lógica e seu tempo e custo de desenvolvimento serão reduzidos. Os aplicativos também serão mais fáceis de gerenciar. APIs REST são usadas rapidamente em aplicativos da Web de página única hoje em dia também.

Escrevi um artigo sobre como escrever APIs REST usando Python.  Obrigado por ler este artigo.