2015-01-19 4 views
46

저는 Restful API를 문서화하는 것을 매우 좋아합니다. 특히 "사용해보십시오!" 버튼이 있지만 swagger-ui 인터페이스가 매우 멋지게 보입니다.왜 swagger-ui에 대한 테마가 없습니까?

그리고 놀랄만한 오픈 소스 도구 용 템플릿이 없다는 것을 믿을 수 없습니까?

무료입니다. http://getbootstrap.com/에는 (https://wrapbootstrap.com/과 같은) 테마를 구입할 수있는 사이트가 많아서 왜곡 된 테마에 대한 사이트를 찾을 수없는 이유는 무엇입니까?

+0

당신이 다음 수준에 취한 Swagger를보고 싶다면 https://www.dynamicapis.com을 확인하십시오. 그들은 Swagger 문서를 가져 와서 멋진 UI를 생성합니다. 다음은 이들이 호스팅하는 API 포털의 예입니다. https://www.dynamicapis.com/dapi/apis/0b971e55-c61f-4428-a65f-ca905bd52762 –

답변

57

좋은 답변 임에도 불구하고 답이 늦었습니다. 이것은 꽤 굉장합니다! 매끄러운 구현이며, 사용자의 필요에 맞게 다시 조정할 수있는 여러 가지 기능을 사용자 정의했습니다 (https://github.com/jensoleg/swagger-ui).

크레딧이 google 그룹에 올리기 : https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI. 이상하게 여기 아직 게시되지 않았습니다. 동작 데모를 들어

,이 링크를 확인하시기 바랍니다 : http://senodio.com/site/swagger/#!/pet/addPet

을 -

편집 : 최근 데모가 다운 된 것을 발견, 그래서 리포 (https://github.com/MartinSahlen/swagger-ui)를 포크와 창조 heroku에서 실행되는 단순 노드/표현 서버. 이것은 무료 영웅 다이노이므로 약간의 활동이없는 경우 (~ 20 초)로드하는 데 약간의 시간이 걸릴 수 있습니다.

당신은 환영합니다 : http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

편집 2 : https://github.com/legendecas/material-swagger-ui : 그냥 유망 보이는 또 다른 하나를 가로 질러왔다. 또한 내가 현재 호스팅하고있는 위선자가 http://swaggerui.herokuapp.com/에 부활 한 것 같습니다. 내 경우에 대비해서 다시 쓰러 뜨릴 수 있습니다.

+0

와우. 좋은. 고맙습니다! –

+1

헤드 업 : 액션 데모 링크가 죽은 것처럼 보입니다. –

+0

예, 알고 있습니다. 너무 오래 걸리지 않는다면 호스트하는 간단한 heroku 앱을 추가하려고합니다. –

4

새로운 도구는 아니지만 Swagger-UI는 작업에 매우 특화되어 있습니다. 나는 그것을 (무료 또는 유료) 테마를 제공하는 모든 웹 사이트를 알지 못합니다. 많은 사용자가 로컬 테마에 맞게 UI를 사용자 정의했습니다. 일부는 미묘한 변화를 일으켰으며 일부는 정밀 검사를 완료했습니다.

사용 가능한 구현을 살펴보고 필요에 맞는 것이 있는지 확인하는 것이 좋습니다. 그런 다음 자신의 필요에 맞게 테마/템플릿을 재사용 할 권한을 요청하십시오.

+0

감사합니다.하지만 이러한 구현을 찾는 것은 불가능하다고 생각합니다. . –

+1

(매우) 부분 목록을 찾을 수 있습니다 - https://github.com/swagger-api/swagger-spec/wiki/Sites-and-Services. – Ron

+0

다시 한 번 감사드립니다! –