2017-11-29 24 views
0

한 시간 이상 Swagger UI 문제에 봉착했습니다. 찾을 수없는 설명을 찾기 위해 문서 및 다양한 게시물을 검색했습니다. .SwaggerUI/YAML - 매핑 항목의 들여 쓰기가 잘못됨 : 이유를 찾을 수 없음

paths: 
    /projects: 
    get: 
     tags: 
     - projects 
     summary: Get projects 
     description: 
     operationId: getProjects 
     responses: 
     200: 
      description: successful operation 
      schema: 
      type: array 
      items: 
       $ref: "#/definitions/Project" 
     security: 
     - api_key: [] 

나에게 다음주기 :

파서 오류 : 매핑 항목의 나쁜 들여 쓰기 (라인 37)

여기 내 YAML 파일의 일부 37 번 줄은 security:입니다.

나를 귀찮게하는 것은 그 후에 동일한 "코드"가 생겼다는 것인데, $ref의 내용 인 유일한 변화 요소는 Swagger Editor에 오류를 생성하지 않습니다.

답변

3
  1. 경로는 /로 시작해야합니다 : /projects.

  2. description은 값 - 최소한 빈 문자열 ""을 필요로합니다. 하나를 설정하는 것을 선호 수도 있지만 설명

+0

값은 같은 표시된 비어있을 수, 즉 유효 YAML은,의에' ""'명시 적으로 – tinita

+0

@tinita :'설명 :'값이 null' '로 평가하지 않고. YAML에서는 유효하지만 OpenAPI/Swagger에서는 유효하지 않습니다. 'description'은 문자열이어야합니다. – Helen

+0

알 겠어 ... 고마워. – tinita