검색 엔드포인트

중국 기업을 이름, 영문 이름 또는 사업자 등록 번호(USCC)로 검색하세요.

요구

GET /wp-json/chinacheckup/v1/search

입증

방법
헤더 (권장) X-API-Key: API 키
쿼리 매개변수 ?토큰=API 키

매개변수

매개변수 유형 필수의 설명
검색어 회사명(중국어 또는 영어) 또는 USCC
현재 페이지 정수 아니요 페이지 매김에 사용할 페이지 번호 (기본값: 1)

예시 요청

GET /wp-json/chinacheckup/v1/search?search_terms=toto&current_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, 보고서는 완전히 번역되어 준비되었습니다.

일반적인 워크플로

  1. 부르다 getFull 또는 기본을 얻으세요 회사 보고서를 요청하다
  2. 투표 번역 상태 가져오기 30~60초마다
  3. 언제 상태 ~이다 ""완벽한"", 번역된 보고서가 준비되었습니다.
  4. 부르다 getFull 다시 완전히 번역된 데이터를 가져오려면