Tools/Stoplight (6) 썸네일형 리스트형 Stoplight 사용 후기 백엔드 개발팀장님의 제안으로 다른 시니어 TW와 함께 Stoplight를 탐구해봤다. 제안을 받은 배경은? TW한테 좋은 툴이라고 함- 결론부터 얘기하면 유료 플랜을 사용하지 않기로 했다. 이유는 비용이 꽤 비싸다. (쓰려면 Pro plan을 써야 하는데) 솔직히 회사에서 비용 지원을 해줄지 모르겠음. 분명히 유용한건 알겠는데- Postman이랑 OpenAPI을 아직 많이 안 써봐서 그런지 회사 & 개발자들한테 이 돈 주고 써야한다고 설득(?)할만큼의 유용함을 깨닫진 못한 것 같다. 일단은 Postman이랑 Swagger를 더 써보고 다시 고려해봐야겠다. Stoplight Migrating from Postman Postman에서 Stoplight로 export할 수 있는데 중간에 Apimatic Transformer에서 변환 과정을 거침 Import Postman Collection | Platform Stoplight enables users to import a Postman Collection file from their local computer directly into Stoplight Studio. Powered by Stoplight. meta.stoplight.io Export 2. Collection v2.1 선택 3. json 파일 local에 저장 4. Transform API 클릭 5. Postman에서 export한 파일 업로드하고 Export Format 선택 (JSON or YAML).. Stoplight Starter 유료 기능 Stoplight에 회사 이메일로 등록했더니 Sales에서 연락왔다. Professional 30일 Free-trial 쿠폰 받음 👍 but Professional은 starter plan보다 가격이 4배 비쌈 (Starter $79, Professional $319) Professional은 비용이 비싸서 지원받기 힘들지 않을까...? 싶어서 Starter 유료 기능 위주로 알아봄 API Design Plans and Pricing | Stoplight | Stoplight Collaborative Design Multi-Branch Support Analytics Integration Custom Domains Theme with Your Colors Up to 50 Projects 5 Users I.. Stoplight Getting started tutorial 실습 후기 Stoplight 자료가 생각보다 찾기 힘들었다. 다행히 영문으로 된 튜토리얼을 찾아냄!! 👏👏 Documenting APIs(a guide for technical writers)라는 사이트인데- 튜토리얼이 정말 상세하다. (이 정도로 디테일하다고?! 싶을 정도로 자세함) Stoplight를 처음 써봄에도 튜토리얼에서 막히는 부분이 없었음!! 드디어 찾았다 내 롤모델 😆 https://idratherbewriting.com/learnapidoc/pubapis_openapis_quickstart_stoplight.html Getting started tutorial: Using Stoplight Studio to create an OpenAPI specification document You can cr.. Stoplight Using References 동료 백엔드 개발자가 추천해준 기능 OpenAPI 기능이긴 하지만 UI로 쉽게 가능하게 해준다. Splitting your API descriptions across multiple files using $ref (references) allows for cleaner and more organized code. Some common use cases are as follows: De-duplicate common structures like models, reducing repetition and allowing them to be used for other purposes like contract testing. Similar parameters or headers can be shared acros.. Stoplight Set Article Visibility 사내에서 추천을 받아 Stoplight를 탐구하고 있는 요즘이다. 사실 Postman이랑 Swagger도 잘 안 써봐서 처음엔 부담이었다. 게다가 Stoplight는 신세계(?)인지 심지어 유데미 인강도 없다. (한국어 블로그 자료도 잘 없음) 다들 뭐 좋더라... 하고 끗..ㅋㅋ 일단은 Technical Writer에게 적합한 툴이라고 하니! 하나하나 유용한 기능들을 톺아보쟈 💪 You can now prevent articles from being visible to external users or users who are not members of a workspace. Internal articles are no longer visible in the Table of Contents or sear.. 이전 1 다음
