{"openapi":"3.0.3","info":{"title":"APICK 대출금리 조회","version":"1.0.0","description":"대출기간별 고정기준금리와 유통수익률을 일자별로 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/loan_interest_rate":{"post":{"summary":"대출금리 조회","description":"대출기간별 고정기준금리와 유통수익률을 일자별로 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"date":{"type":"string","description":"요청한 날짜 YYYY-MM-DD입니다."},"as_of_date":{"type":"string","description":"실제 고시일 YYYY-MM-DD입니다. 요청일이 주말·공휴일이면 직전 영업일입니다."},"count":{"type":"integer","description":"rates에 담긴 금리 개수입니다."},"rates":{"type":"array","items":{"type":"object","properties":{"term":{"type":"string","description":"대출기간입니다. 예: 1년, 3년, 수은채 유통수익률 6개월."},"rate":{"type":"number","description":"그 기간의 금리(%)입니다."}}},"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":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"date":{"type":"string","description":"조회 일자 YYYYMMDD (예: 20261114). 생략하면 오늘 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"20261114"}}}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","의미","대처"],"rows":[["조회 일자(date)는 YYYYMMDD 형식입니다. 예: 20261114","date 형식이 틀렸거나 1990년 이전입니다.","형식을 고쳐 다시 요청합니다."],["미래 날짜는 조회할 수 없습니다. …","오늘 이후 날짜를 보냈습니다.","오늘 또는 그 이전 날짜로 요청합니다."],["해당 일자의 대출금리 정보가 없습니다. …","그 날짜와 직전 영업일까지 금리가 없습니다.","영업일 기준으로 다시 요청합니다. 과금되지 않습니다."],["대출금리 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","일시적으로 조회하지 못했습니다.","잠시 후 다시 요청합니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}