Como funciona
Uma API REST (Representational State Transfer) usa os verbos do HTTP (GET, POST, PUT, PATCH, DELETE) para operar sobre recursos identificados por URLs. Cada requisição é independente: o servidor não guarda o estado da conversa entre chamadas, e toda informação necessária vai na própria requisição, nos cabeçalhos ou no corpo. As respostas costumam vir em JSON, com códigos de status HTTP indicando sucesso (2xx) ou erro (4xx, 5xx). O estilo REST também valoriza cache, interface uniforme e separação entre cliente e servidor.
Exemplo prático
Imagine um app de tarefas. Para listar tarefas, o cliente faz GET /tarefas. Para criar uma, faz POST /tarefas com um JSON no corpo. Para apagar, faz DELETE /tarefas/42. O mesmo padrão vale para APIs de IA: você envia um POST com o prompt e recebe o texto gerado em JSON. Webhooks complementam esse fluxo enviando eventos de volta ao seu sistema.
Para que serve
REST é o padrão mais comum para integrar sistemas, porque usa a infraestrutura web já existente, é fácil de testar em navegador ou curl e funciona com qualquer linguagem. Para quem constrói agentes de IA, APIs REST são a ponte entre o modelo e ferramentas externas, como bancos de dados, sistemas de arquivos e serviços de terceiros. GraphQL oferece uma alternativa quando o cliente precisa de campos específicos.
Boas práticas
Use nomes de recursos no plural, versione a API, retorne códigos de status adequados e documente os endpoints. Isso facilita a manutenção e a integração por outros desenvolvedores e agentes.