{"openapi":"3.0.3","info":{"title":"APICK 부정당제재 업체 조회","version":"1.0.0","description":"사업자등록번호로 조회 시점에 유효한 부정당제재 여부와 제재 내용을 확인합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/debarred_company":{"post":{"summary":"부정당제재 업체 조회","description":"사업자등록번호로 조회 시점에 유효한 부정당제재 여부와 제재 내용을 확인합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"business_no":{"type":"string","description":"조회한 사업자등록번호입니다."},"checked_at":{"type":"string","description":"조회 시각(ISO 8601)입니다."},"status":{"type":"string","description":"active_sanctions_found(유효 제재 있음) 또는 no_active_sanctions(없음)입니다."},"count":{"type":"integer","description":"제재 건수입니다."},"sanctions":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"제재 번호입니다. 없으면 null입니다.","nullable":true},"name":{"type":"string","description":"제재명입니다. 없으면 null입니다.","nullable":true},"agency":{"type":"string","description":"제재 기관입니다. 없으면 null입니다.","nullable":true},"start_date":{"type":"string","description":"제재 시작일입니다. 없으면 null입니다.","nullable":true},"end_date":{"type":"string","description":"제재 종료일입니다. 없으면 null입니다.","nullable":true},"basis":{"type":"string","description":"제재 근거입니다. 없으면 null입니다.","nullable":true}}},"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":{"bizno":{"type":"string","description":"사업자등록번호 10자리 (하이픈 허용) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"1234567890"}},"required":["bizno"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","의미","대처"],"rows":[["사업자등록번호(bizno)는 숫자 10자리입니다. 하이픈은 붙여도 됩니다.","bizno가 없거나 숫자 10자리가 아닙니다.","형식을 고쳐 다시 요청합니다."],["부정당제재 정보를 가져오지 못했습니다.","일시적으로 조회하지 못했습니다.","잠시 후 다시 요청합니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}