API 요청
/rest/dart_company요청 파라미터 1개 · 필수 1
corpCode- 예시
00126380
응답 필드 6개
datadata.companyapiapi.costapi.successapi.ms전자공시에 등록된 기업의 개황을 고유번호 하나로 조회합니다. 정식명칭·영문명·대표자·주소·업종·설립일·결산월 등을 확인할 때 씁니다.
https://apick.app/rest/dart_company왜 기업 스냅샷인가
거래처나 투자 대상을 볼 때 기본 정보와 업종, 대표, 소재지를 따로 찾게 됩니다. 기업 식별값을 넘겨 개요를 한 번에 받아 검토 자료로 씁니다.
성공한 조회 한 건당 30P가 차감됩니다. 실제 차감액은 응답의 api.cost에서 확인하세요.
고유번호(8자리)로 조회합니다. 회사명으로 고유번호를 찾는 기능은 제공하지 않으므로, 이름만 있을 때는 공시 검색으로 고유번호를 먼저 확인하세요.
인증키는 서버 환경변수에 보관하고 공개 저장소·웹페이지에 넣지 마세요.
/rest/dart_companycorpCode00126380datadata.companyapiapi.costapi.successapi.msPOST https://apick.app/rest/dart_companyAuthorization: Bearer — 내 계정의 API 인증키multipart/form-datacorpCode — 고유번호 8자리고유번호로 기업 개황을 받는 예입니다. 성공 시 과금되는 실제 요청입니다.
HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.{
"data": {
"error": "입력값을 확인해 주세요.",
"success": 0
},
"api": {
"success": true,
"cost": 0,
"ms": 5
}
}{
"data": { "company": {} },
"api": { "cost": 30, "success": true, "ms": 240 }
}
고유번호가 8자리 숫자가 아니면 조회 전에 data.error로 실패합니다. 없는 고유번호면 조회된 데이터가 없습니다.가 오고 api.cost는 0이며, 기업 정보를 가져오지 못하면 공개 안내 문구가 옵니다.
FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.
같은 요청을 JavaScript와 Python으로 옮긴 예시입니다. 키는 환경변수 APICK_API_KEY 에서 읽습니다.