API Blueprint | API Blueprint
API Blueprint. Uma poderosa linguagem de descrição da API de alto nível para APIs web.
API Blueprint é simples e acessível a todos os envolvidos no ciclo de vida da API. Sua sintaxe é concisa, porém expressiva. Com o API Blueprint você pode rapidamente projetar e criar protótipos de APIs ou documentar e testar APIs já implantadas de missão crítica.
Secção de Ferramentas tutoriais
# GET /message+ Response 200 (text/plain) Hello World!
Focused on Collaboration
API Blueprint é construído para encorajar o diálogo e a colaboração entre os interessados no projeto, desenvolvedores e clientes em qualquer ponto do ciclo APIlifecycle. Ao mesmo tempo, as ferramentas do API Blueprint fornecem o suporte para atingir os objetivos seja o desenvolvimento, a governança ou a entrega da API.
Abrir
API Blueprint é completamente aberto sob a licença do MIT. Ao invés disso, ele usa o processo RFC similar à linguagem Rust ou processos RFC Django Enhancement Proposal.
Para contribuir, envie uma proposta para o repositório RFC da API Blueprint.
Em casa no GitHub
A linguagem API Blueprint é reconhecida pelo GitHub.Search for API Blueprint on GitHub usando a consultalanguage:"API Blueprint"
.
O tipo de mídia para API Blueprint é text/vnd.apiblueprint
, e a extensão do arquivo thestandard é .apib
. Se você usar esta extensão, suas impressões em azul no GitHub serão iluminadas por sintaxe.
Built for better API Designs
API Blueprint é construído para encorajar melhores designs de API através da abstração. O objetivo do API Blueprint é desacoplar elementos da API para permitir a modularidade enquanto encapsula o comportamento da implementação backend.
Por exemplo, modele seus dados primeiro usando a sintaxe de descrição dos dados.
# Data Structures## Blog Post (object)+ id: 42 (number, required)+ text: Hello World (string)+ author (Author) - Author of the blog post.## Author (object)+ name: Boba Fett+ email: [email protected]
Então, use e reutilize os dados em seus pontos finais da API.
# Blog Posts ## Retrieve All Posts + Response 200 (application/json) + Attributes (array)
Design-first
API Blueprint é tudo sobre a filosofia design-first. Similar aos testes de desenvolvimento orientado a testes, API Blueprint representa um contrato para uma API. Discutir a sua API e estabelecer-se no contrato antes de ser desenvolvido tende a conduzir a melhores designs API.
A partir do momento que a sua API Blueprint está no lugar, todos podem testar se a implementação está a cumprir com as expectativas estabelecidas no contrato.
Ferramentas fantásticas
Pelas suas abrangentes adopções existe uma infinidade de ferramentas construídas para o API Blueprint. Desde várias ferramentas autónomas tais como mock server, documentação e ferramentas de teste até soluções completas de ciclo de vida API.
Veja a seção Ferramentas da lista.
Começando
Para começar com o API Blueprint você vai precisar de um editor de texto simples. Para a melhor experiência de edição mude a sintaxe para Markdown ou diretamente para API Blueprint (se suportado pelo seu editor).
Com o editor pronto, siga o tutorial da API Blueprint.
Após você ter escrito sua primeira API Blueprint você pode discutir a API designada com amigos e usar as ferramentas para API Blueprint. Por exemplo, para renderizar documentação, gerar um mock do seu serviço ou começar a testar a implementação do yourbackend.