{"openapi":"3.0.3","info":{"title":"APICK 공휴일 조회","version":"1.0.0","description":"해당 년월의 공휴일 정보를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/holiday_info":{"post":{"summary":"공휴일 조회","description":"해당 년월의 공휴일 정보를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"result":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"공휴일 날짜 YYYYMMDD입니다."},"dateName":{"type":"string","description":"공휴일 이름입니다. 예: 설날, 대체공휴일(설날)."},"isHoliday":{"type":"string","description":"공휴일이면 Y입니다."},"locdate":{"type":"integer","description":"date와 같은 날짜를 숫자로 담은 값입니다. 날짜 비교에는 date를 쓰세요."}}},"description":"그 달의 공휴일 목록입니다. 날짜 순으로 옵니다. 공휴일이 없는 달은 빈 배열입니다."},"success":{"type":"integer","description":"1이면 정상 조회입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0 입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"year":{"type":"string","description":"조회할 연도(4자리)입니다. 1900~2200 범위이며, 예: 2024. 자료가 없는 연도는 빈 결과가 올 수 있습니다. (string)","example":"2024"},"month":{"type":"string","description":"조회할 월입니다. 1~12 범위이며, 두 자리로 보내려면 02처럼 앞에 0을 붙입니다. (string)","example":"02"}},"required":["year","month"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","의미","대처"],"rows":[["입력 항목이 잘못됐습니다.","year가 1900~2200 밖이거나 month가 1~12 밖입니다.","숫자 범위를 고쳐 다시 요청합니다."],["공휴일 정보를 가져오지 못했습니다.","일시적으로 조회하지 못했습니다.","잠시 후 다시 요청합니다. 과금되지 않습니다."],["알 수 없는 이유로 실패했습니다.","일시적인 실패입니다.","잠시 후 다시 요청합니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}