인터페이스 문서 생 성 도구 - apidoc

1196 단어 자바 script
apiDoc 은 원본 코드 에서 API 설명 을 만들어 api 설명 문 서 를 생 성 합 니 다.http://apidocjs.com/#param-ap...
사용 방법
저희 가 express 프로젝트 를 예 로 들 면...
1 apidoc. json 만 들 기
{
  "name": "abc   api   ",
  "version": "1.0.0",
  "description": "    ",
  "title": "abc  api  ",
  "url" : "localhost:3000/api",
  "template": {
    "withCompare": true,
    "withGenerator": true
  }
}

2. 저 희 는 routes 폴 더 에서 api 폴 더 를 만 들 고 인터페이스 설명 을 작성 합 니 다. 예 를 들 어
/**
 * @api {get} /news/newsContent     
 * @apiVersion 1.0.0
 * @apiName newsContent
 * @apiGroup news
 * @apiParam {Number} id   id
 * @apiSuccess {Number} code     
 * @apiSuccess {String} message     
 * @apiSuccess {Object} data     
 * @apiSuccessExample Success-Response:
 *     HTTP/11 200 OK
 *     {
 *       "code": 1,
 *       "mess": "  ",
 *       "data": {}
 *     }
 */ 

3 호출 생 성 명령
apidoc -i routes/ -o public/apidoc/

이상 명령 은 routes 폴 더 의 api 설정 을 읽 고 api 설명 문 서 를 Public / apidoc / 폴 더 로 출력 하여 생 성 된 index. html 를 열 면 됩 니 다.

좋은 웹페이지 즐겨찾기