jciterceros / api-with-swagger Goto Github PK

API REST, ou Arquitetura de Transferência de Estado Representacional, é um conjunto de princípios e convenções para projetar e interagir com serviços web. É amplamente usado na construção de aplicativos web e móveis.

• Recursos: Tudo em uma API REST é considerado um recurso, como usuários, produtos ou posts.
• Verbos HTTP: Ela utiliza os verbos HTTP (GET, POST, PUT, DELETE) para realizar operações nos recursos.
• Stateless: Cada requisição para a API deve conter todas as informações necessárias, tornando a API independente de estado.
• Representações: Os recursos podem ser representados em diferentes formatos, como JSON ou XML.
• URI (Uniform Resource Identifier): Cada recurso é acessado por meio de uma URI única.
• HATEOAS: Uma API REST pode incluir links para recursos relacionados, permitindo a descoberta dinâmica de endpoints.

• Simplicidade e fácil compreensão.
• Integração com várias plataformas e linguagens.
• Escalabilidade e flexibilidade.
• Padrão amplamente adotado na indústria.

Em resumo, uma API REST é uma abordagem padrão para a criação de serviços web que é simples, escalável e amplamente aceita na indústria de desenvolvimento de software.

API de testes com Swagger Veja a documentação.