검색 엔드포인트
중국 기업을 이름, 영문 이름 또는 사업자 등록 번호(USCC)로 검색하세요.
요구
GET /wp-json/chinacheckup/v1/search
입증
| 방법 | 예 |
|---|---|
| 헤더 (권장) | X-API-Key: API 키 |
| 쿼리 매개변수 | ?토큰=API 키 |
매개변수
| 매개변수 | 유형 | 필수의 | 설명 |
|---|---|---|---|
검색어 |
끈 | 예 | 회사명(중국어 또는 영어) 또는 USCC |
현재 페이지 |
정수 | 아니요 | 페이지 매김에 사용할 페이지 번호 (기본값: 1) |
예시 요청
GET /wp-json/chinacheckup/v1/search?search_terms=toto¤t_page=1 헤더: X-API-Key: YOUR_API_KEY
응답
{ "total_results": 649, "current_page": "1", "companylist": { "9295814": { "name": "东陶(中國)유유공회사", "creditCode": "91110000625910848Y", "city": "Beijing", "base": "北京", "registered_english_name": "Dongtao (China) Co., Ltd.", "auto_english_name": "", "companyType": 1, "companyTypeText": "회사" }, "2344995451": { "name": "南京东陶유유공사", "creditCode": "91320115608929125H", "도시": "난징", "기지": "江苏", "registered_english_name": "Nanjing TOTO Co.,Ltd.", "auto_english_name": "", "companyType": 1, "companyTypeText": "Company" } } }
응답 필드
| 필드 | 유형 | 설명 |
|---|---|---|
총 결과 |
정수 | 일치하는 회사 총 수 |
현재 페이지 |
끈 | 현재 페이지 번호 |
회사 목록 |
물체 | 회사 ID → 회사 데이터 지도 |
회사 목표
| 필드 | 유형 | 설명 |
|---|---|---|
이름 |
끈 | 중국 회사명 |
크레딧코드 |
끈 | USCC(통합 사회 신용 코드) - 18자리 |
도시 |
끈 | 도시 이름 (영어로 번역) |
베이스 |
끈 | 성/지역 (중국어) |
등록된 영어 이름 |
끈 | 공식 등록된 영문 명칭 (있는 경우) |
자동 영어 이름 |
끈 | 공식 명칭이 없는 경우 자동 번역된 영어 이름 |
회사 유형 |
정수 | 회사 유형 코드 (1 = 회사, 2 = 개인) |
회사유형텍스트 |
끈 | 회사 유형 라벨 |
비용
무료 (0학점) – 추적 목적으로 기록되었습니다.
오류 응답
| 상태 | 암호 | 설명 |
|---|---|---|
| 400 | 누락된 용어 |
없어진 검색어 매개변수 |
| 400 | 지갑 없음 |
사용자에게 지갑이 설정되어 있지 않습니다. |
| 401 | 누락된 API 키 |
API 키가 제공되지 않았습니다. |
| 403 | 잘못된 API 키 |
잘못된 API 키입니다. |
메모
- 페이지당 최대 5개의 결과를 표시합니다.
- 사용
크레딧코드(미국법전) 후속 조항기본을 얻으세요또는getFull통화 - 없는 회사
크레딧코드또는도시상세 보고서를 조회할 수 없습니다.
회사 전체 데이터 엔드포인트 가져오기
등록 정보, 사업 데이터, 사법 기록, 위험 평가 및 AI 기반 분석을 포함한 포괄적인 회사 정보를 검색하세요.
요구
GET /wp-json/chinacheckup/v1/getFull
입증
| 방법 | 예 |
|---|---|
| 헤더 (권장) | X-API-Key: API 키 |
| 쿼리 매개변수 | ?토큰=API 키 |
매개변수
| 매개변수 | 유형 | 필수의 | 설명 |
|---|---|---|---|
미국 |
끈 | 예 | 회사 USCC(통합 사회 신용 코드) – 18자리 |
예시 요청
GET /wp-json/chinacheckup/v1/getFull?uscc=91110000625910848Y 헤더: X-API-Key: YOUR_API_KEY
응답
{ "name": "동타오(중국) 유한회사", "registered_english_name": "동타오(중국) 유한회사", "creditCode": "91110000625910848Y", "regStatus": "Active", "regStatus_interpretation": "이 상태는 회사가 존재하며 운영 중임을 나타냅니다.", "estiblishTime": "1995-08-18", "estiblishTime_formatted": "1995-08-18", "company_age_years": "29", "percentileScore": "85%", "regCapital": "USD 50,000,000", "actualCapital": "USD 50,000,000", "companyOrgType": "유한책임회사" (외국인 투자)", "도시": "베이징", "본사": "베이징", "구": "차오양", "등록 위치": "베이징시 차오양구 예시로 123번지", "사업 범위": "위생 도기 제조 및 판매...", "법적 담당자 이름": "장웨이", "법적 담당자 유형": "개인", "전화번호": "010-12345678", "이메일": "contact@example.com", "웹사이트": "www.example.com", "주요 산업": "제조업", "산업 규모": "위생 도기", "직원 수 범위": "1000-4999명", "실무 직원 수": 2500명, "분석": "이 회사는 잘 설립된 외국인 투자 기업입니다..." "risk_info": { "riskLevel": "low", "ownRiskTotal": 0, "associatedRiskTotal": 2, "categories": [...] }, "staffList": [...], "shareHolderList": [...], "branchList": [...], "lawSuitList": [...], "changeList": [...], "translation_complete": 1, "_credits": 95, "_already_purchased": false }
응답 필드
기본 정보
| 필드 | 유형 | 설명 |
|---|---|---|
이름 |
끈 | 중국 회사명 |
등록된 영어 이름 |
끈 | 공식 등록된 영어 명칭 |
크레딧코드 |
끈 | 미국 헌법 (18자) |
등록 상태 |
끈 | 등록 상태 (예: 활성, 취소됨) |
regStatus_interpretation |
끈 | 등록 상태에 대한 설명 |
설립 시간 |
끈 | 회사 설립일 |
회사 설립 연도(년) |
끈 | 회사 설립 연도(년) |
백분위수 점수 |
끈 | 회사 신뢰도 점수 (0-100%) |
재무 정보
| 필드 | 유형 | 설명 |
|---|---|---|
레그캐피탈 |
끈 | 등록 자본금 |
실제 자본 |
끈 | 실제 납입 자본 |
위치 및 연락처
| 필드 | 유형 | 설명 |
|---|---|---|
도시 |
끈 | 도시 (번역됨) |
베이스 |
끈 | 주/지역 (번역됨) |
구역 |
끈 | 구역 |
regLocation |
끈 | 등록 된 주소 |
전화번호 |
끈 | 연락처 전화번호 |
이메일 |
끈 | 연락처 이메일 |
웹사이트 |
끈 | 회사 웹사이트 |
비즈니스 정보
| 필드 | 유형 | 설명 |
|---|---|---|
회사 조직 유형 |
끈 | 회사 조직 유형 |
비즈니스 범위 |
끈 | 사업 범위 설명 |
산업주요 |
끈 | 주요 산업 분야 |
인더스트리빅 |
끈 | 산업 주요 범주 |
산업중간 |
끈 | 산업 중간 범주 |
산업 중소기업 |
끈 | 산업 소규모 범주 |
직원 수 범위 |
끈 | 직원 수 범위 |
사회 직원 수 |
정수 | 사회보험에 등록된 직원 |
legalPersonName |
끈 | 법정대리인 이름 |
법적 인격 유형 |
끈 | 법정대리인 유형 (개인/회사) |
위험 평가
| 필드 | 유형 | 설명 |
|---|---|---|
위험 정보 |
물체 | 종합적인 위험 평가 데이터 |
분석 |
끈 | AI가 생성한 기업 분석 |
리스트(배열)
| 필드 | 유형 | 설명 |
|---|---|---|
직원 목록 |
정렬 | 주요 인력 및 임원 |
주주 목록 |
정렬 | 주주 및 소유 구조 |
브랜치리스트 |
정렬 | 지점 |
investList |
정렬 | 다른 회사에 대한 투자 |
소송 목록 |
정렬 | 법적 사건 및 소송 |
법원공지목록 |
정렬 | 법원 발표 |
부정직한 목록 |
정렬 | 부정직한 채무자 기록 |
비정상 목록 |
정렬 | 사업 이상 |
변경 목록 |
정렬 | 회사 변경 내역 |
historyNameList |
정렬 | 이전 회사명 |
메타데이터
| 필드 | 유형 | 설명 |
|---|---|---|
번역 완료 |
정수 | 번역 상태 (0 = 진행 중, 1 = 완료) |
_크레딧 |
정수 | 남은 크레딧 잔액 |
이미 구매됨 |
부울 | 이 보고서가 이전에 구매되었는지 여부 |
비용
1학점 고유 회사(USCC)당 한 번만 청구 가능합니다. 동일한 USCC에 대한 후속 청구는 무료입니다.
오류 응답
| 상태 | 암호 | 설명 |
|---|---|---|
| 400 | missing_uscc |
없어진 미국 매개변수 |
| 400 | 지갑 없음 |
사용자에게 지갑이 설정되어 있지 않습니다. |
| 401 | 누락된 API 키 |
API 키가 제공되지 않았습니다. |
| 402 | 크레딧 부족 |
보고서를 구매하기에 크레딧이 부족합니다. |
| 403 | 잘못된 API 키 |
잘못된 API 키입니다. |
메모
- 데이터는 180일 동안 캐시되며, 이후 호출 시 추가 API 비용 없이 캐시된 데이터가 반환됩니다.
- 첫 번째 호출은 소스에서 데이터를 가져오는 데 시간이 더 오래 걸릴 수 있습니다.
- 확인하다
번역 완료필드 – 만약0, 일부 필드는 여전히 중국어로 되어 있을 수 있습니다. - 사용
번역 상태 가져오기번역 완료 여부를 확인하기 위해 설문조사를 실시합니다. - 그만큼
이미 구매됨해당 필드는 이 통화가 유료였는지 무료였는지(이전에 구매했는지 여부)를 나타냅니다.
번역 상태 가져오기 엔드포인트
회사 보고서의 번역 상태를 확인하세요. 보고서는 요청 후 자동으로 중국어에서 영어로 번역됩니다.
요구
GET /wp-json/chinacheckup/v1/getTranslationStatus
입증
| 방법 | 예 |
|---|---|
| 헤더 (권장) | X-API-Key: API 키 |
| 쿼리 매개변수 | ?토큰=API 키 |
매개변수
| 매개변수 | 유형 | 필수의 | 설명 |
|---|---|---|---|
미국 |
끈 | 예 | USCC(통합 사회 신용 코드) 회사 |
예시 요청
GET /wp-json/chinacheckup/v1/getTranslationStatus?uscc=91110000625910848Y 헤더: X-API-Key: YOUR_API_KEY
응답
{ "uscc": "91110000625910848Y", "translation_complete": 1, "status": "complete" }
응답 필드
| 필드 | 유형 | 설명 |
|---|---|---|
미국 |
끈 | 요청된 회사 USCC |
번역 완료 |
정수 | 번역 상태 코드(아래 참조) |
상태 |
끈 | 사람이 읽을 수 있는 상태 |
번역 상태 코드
| 암호 | 상태 | 설명 |
|---|---|---|
| 0 | 진행 중 |
번역이 진행 중이거나 보류 중입니다. |
| 1 | 완벽한 |
번역이 완료되었습니다. 보고서가 준비되었습니다. |
| 2 | 진행 중 |
확인은 완료되었으나 아직 처리가 완료되지 않았습니다. |
비용
무료 (0 크레딧) – 번역 상태 확인은 무료입니다.
오류 응답
| 상태 | 암호 | 설명 |
|---|---|---|
| 400 | missing_uscc |
없어진 미국 매개변수 |
| 401 | 누락된 API 키 |
API 키가 제공되지 않았습니다. |
| 403 | 잘못된 API 키 |
잘못된 API 키입니다. |
메모
- 해당 회사에 대한 요청이 이전에 접수된 적이 없다면, 이 엔드포인트는 초기 데이터 가져오기를 트리거합니다.
- 번역은 일반적으로 몇 분 안에 완료됩니다.
- 이 엔드포인트를 주기적으로 확인하여 보고서를 볼 수 있는 준비가 되었는지 확인하십시오.
- 한 번
번역 완료~이다1, 보고서는 완전히 번역되어 준비되었습니다.
일반적인 워크플로
- 부르다
getFull또는기본을 얻으세요회사 보고서를 요청하다 - 투표
번역 상태 가져오기30~60초마다 - 언제
상태~이다""완벽한"", 번역된 보고서가 준비되었습니다. - 부르다
getFull다시 완전히 번역된 데이터를 가져오려면