Comments (6)
Sobre isso teve um cara que postou várias soluções, não me pareceu que o swagger era o melhor. Mas de documentação creio que seja esse o caminho.
Mas ainda seria legal uma Single Page Screen, com uns forms para testar e a implementação da API em várias linguagens..
from brasilapi.
@Juloko Acredito que utilizar o swagger seria bem legal:
https://app.swaggerhub.com/apis/ft-phillip-proulx/Tricon-Smart-Action/1.0
Já utilizei plugins do express que geravam ele de maneira automática, havia um "/api/docs" onde eram descritos todos os endpoints, entidades, eschemas, respostas e é possível efetuar testes.
Talvez seria uma solução interessante aqui, o que acham?
from brasilapi.
Lembra qual julgava ser melhor que o swagger, a vantagem dele é que é o mais utilizado e a maioria das techs tem maneiras e libs que geram o open api automático para você, e como dev eu prefiro consumir ele que qualquer outro, pois já estou acostumado a documentar e a consumir documentação de apis com ele.
Mas se tiver outra ferramenta legal manda ai, e se definirmos uma legal, vamos trabalhar em um PR implementando ela, o que acha?
from brasilapi.
Acredito que a #14 tenha as pessoas corretas e seja o local correto pra discutir sobre isso. Mas pela tua paixão, vou dar uma olhada nele e tentar implementar em alguma aplicação minha. Vlw!
from brasilapi.
@Juloko hehe mas nada, sem paixões hehe se julgar algum legal, bora! Vou ver lá a outra issue, valeu!!
from brasilapi.
Penso que seria muito interessante utilizarmos React para fazer o Front-End com Consultar CEP e até para ser uma parte gráfica da aplicação para ficar mais dinâmica a consulta.
from brasilapi.
Related Issues (20)
- API CNPJ - Email Response HOT 4
- Campo CNPJ diferente da documentação HOT 1
- Cep incorreto quando consultado na api HOT 1
- API de consulta de veículos por placa HOT 3
- Endpoint CNPJ fora do ar HOT 4
- API Consulta Cnpj HOT 2
- Testes quebrando no ncm.
- Alguns CEPs retornando 404 HOT 13
- Alguns CEPs só são encontrados com hífen. Outros só são encontrados sem hífen HOT 2
- CEP V2 - Não encontra geolocalização HOT 10
- Possible error with Cache-Control caching HOT 5
- Consulta CEP V2 - possível problema na comunicação com serviços HOT 4
- Hoje está dando erro parra qquer CEP HOT 7
- Busca de cidades por UF traz 0 resultados para a sigla AP - Amapá HOT 2
- CEPs V1 - Erro - strict-origin-when-cross-origin HOT 1
- Erro ao consultar CNPJ HOT 9
- Erro em todos serviços de consulta de CEP (https://brasilapi.com.br/api/cep/v2/38408224) HOT 1
- Erro ao consultar CEP Api V2, para qualquer endereço HOT 16
- API CNPJ retornando 404 para qualquer CNPJ HOT 4
- Erro ao consultar CEP Api V1, para qualquer endereço HOT 6
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from brasilapi.