Entenda o que é uma API.
Uma lição de 7 minutos: o que é uma API, o contrato entre programas, suas 4 peças com um exemplo real e um teste de 3 perguntas.
O que é uma API e como ler um pedido, um endpoint e uma resposta em formato JSON.
O caso
Seu app do clima não mede a temperatura. Ele pede a alguém.
Em 7 minutos você vai saber o que é uma API, como viajam um pedido e sua resposta, e vai ler uma troca real como quem lê uma conversa.
O que você vai aprender
- Explicar o que é uma API com suas palavras
- Localizar pedido, endpoint, resposta e formato num exemplo
- Ler uma troca GET com JSON sem programar
O contrato entre programas
Uma API é um acordo: um programa pede algo de um jeito concreto e outro responde de um jeito concreto. Se você entende o acordo, entende a API.
Pedido
O que um programa pede: para onde e o que quer.
Endpoint
O endereço exato que atende cada solicitação.
Resposta
O que o outro lado devolve, com um estado.
Formato
O idioma combinado da resposta, normalmente JSON.
Perguntas frequentes
O que é uma API?
Um acordo para dois programas se comunicarem: um pede de um jeito concreto e o outro responde de um jeito concreto.
Preciso saber programar?
Não: esta lição ensina a ler trocas, não a escrever código.
Teste você mesmo: Teste-relâmpago: você fala API?
O que é uma API?
Resposta certa: Um contrato para dois programas pedirem e devolverem coisas.
A API não é o app nem os dados: é o acordo que permite pedi-los e recebê-los de forma previsível.
Seu app do clima mostra 21°. O que aconteceu por trás?
Resposta certa: O app pediu o dado a uma API e mostrou sua resposta.
O app não mede nada: pede a um endpoint e apresenta a resposta. Ele é o cliente, não o meteorologista.
Você vê GET /tiempo → {temp: 21}. O que significa?
Resposta certa: Alguém pede o tempo e recebe 21 no formato combinado.
GET é o verbo (me dê), /tiempo o endereço e {temp: 21} a resposta combinada. Contrato cumprido.
A regra de bolso — Uma API é um contrato: quem pede, a qual endereço, o que devolve e em qual formato. Se você localizar essas quatro coisas, entende.
O que você leva
Explicar o que é uma API e ler um pedido e sua resposta.