Api Blueprint MSON의 Excel 테이블과 같은 json 스키마가 있습니까?Api Blueprint MSON에 Excel 테이블과 같은 json 스키마가 있습니까?
저는 여러 클라이언트 사이에 일부 API를 설계하고 있습니다. 그래서 쉽게 읽을 수있는 형식으로 제공 할 수있는 API 문서 도구가 필요합니다. 이 3 가지 솔루션을 검색합니다. (Swagger, RAML, Api Blueprint). Api 청사진을 결정할 때 Markdown으로 더 풍부한 양식을 제시 할 수 있기 때문입니다. Api 청사진의 거의 모든 기능이 저를 만족 시켰습니다. 그러나 json 스키마 형식은 복잡하고 읽기가 어렵습니다. 나는 내 결과 HTML을 마침내 아래와 같이 원한다. 는 (내가 API를 청사진 HTML 렌더링으로 aglio을 사용했다.)
이이 현재 Aglio에서 지원되지 않습니다 내 apib 소스 코드
FORMAT: 1A
# GET /MyApi
- Request
- Attributes
- name : hhd (string, required) - this is person name
- age : 37 (number, optional) - this is person age
- pets (array)
- (object)
- name : tom (string, optional) - this is pet's name
- type : dog (string, required) - this is pet's type
- (object)
- name : jane
- type : cat
- Response 200
- Attributes
- status : ok (string, required)
- id : 1000 (number, required)
- name : hhd (string, required) - this is person name
- age : 37 (number, optional) - this is person age
- pets : (array)
- (object)
- id : 10001 (number, required)
- name : tom (string, optional) - this is pet's name
- type : dog (string, required) - this is pet's type
- (object)
- id : 10002
- name : jane
- type : cat