Конечная точка поиска

Поиск китайских компаний по названию, английскому названию или номеру лицензии на ведение бизнеса (USCC).

Запрос

GET /wp-json/chinacheckup/v1/search

Аутентификация

Метод Пример
Заголовок (предпочтительный) X-API-Key: ваш-API-ключ
Параметр запроса ?token=your-api-key

Параметры

Параметр Тип Необходимый Описание
поисковые термины нить Да Название компании (на китайском или английском языке) или USCC
текущая страница целое число Нет Номер страницы для нумерации (по умолчанию: 1)

Пример запроса

GET /wp-json/chinacheckup/v1/search?search_terms=toto&current_page=1 Header: X-API-Key: YOUR_API_KEY

Ответ

{ "total_results": 649, "current_page": "1", "companylist": { "9295814": { "name": "东陶(中国)有限公司", "creditCode": "91110000625910848Y", "city": "Пекин", "base": "北京", "registered_english_name": "Dongtao (China) Co., Ltd.", "auto_english_name": "", "companyType": 1, "companyTypeText": "Company" }, "2344995451": { "name": "南京东陶有限公司", "creditCode": "91320115608929125H", "город": "Нанкин", "base": "Цзянсу", "registered_english_name": "Nanjing TOTO Co.,Ltd.", "auto_english_name": "", "companyType": 1, "companyTypeText": "Компания" } } }

Поля ответа

Поле Тип Описание
total_results целое число Общее количество компаний-партнеров
текущая страница нить Текущий номер страницы
список компаний объект Карта идентификаторов компаний → данные о компании

Объект компании

Поле Тип Описание
имя нить Китайское название компании
кредитный код нить Единый код социального кредита (USCC) – 18 символов
город нить Название города (перевод на английский)
база нить Провинция/регион (на китайском языке)
зарегистрированное_английское_имя нить Официальное зарегистрированное английское название (если таковое имеется)
auto_english_name нить Автоматически переведенное английское название (если нет официального названия)
тип компании целое число Код типа компании (1 = Компания, 2 = Физическое лицо)
компанияТипТекст нить Тип этикетки компании

Расходы

Бесплатно (0 кредитов) – Занесено в систему для отслеживания.

Ответы об ошибках

Статус Код Описание
400 missing_terms Отсутствующий поисковые термины параметр
400 no_wallet У пользователя не настроен кошелек.
401 missing_api_key API-ключ не предоставлен.
403 invalid_api_key Недействительный ключ API

Примечания

  • Возвращает до 5 результатов на странице
  • Использовать кредитный код (USCC) для последующего getBasic или получитьПолный звонки
  • Компании без кредитный код или город Невозможно запросить подробные отчеты.

Получить полную информацию о компании через конечную точку

Получите исчерпывающую информацию о компании, включая регистрационные данные, деловую информацию, судебные записи, оценку рисков и анализ на основе искусственного интеллекта.

Запрос

GET /wp-json/chinacheckup/v1/getFull

Аутентификация

Метод Пример
Заголовок (предпочтительный) X-API-Key: ваш-API-ключ
Параметр запроса ?token=your-api-key

Параметры

Параметр Тип Необходимый Описание
USCC нить Да Единый код социального кредита компании (USCC) – 18 символов

Пример запроса

GET /wp-json/chinacheckup/v1/getFull?uscc=91110000625910848Y Header: X-API-Key: YOUR_API_KEY

Ответ

{ "name": "东陶(中国)有限公司", "registered_english_name": "Dongtao (China) Co., Ltd.", "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": "Limited Liability Company (Иностранные инвестиции)", "город": "Пекин", "база": "Пекин", "район": "Чаоян", "местоположение": "Улица Пример, 123, район Чаоян, Пекин", "сфера деятельности": "Производство и продажа сантехники...", "имя юридического лица": "Чжан Вэй", "тип юридического лица": "лицо", "номер телефона": "010-12345678", "электронная почта": "contact@example.com", "веб-сайт": "www.example.com", "основная отрасль": "производство", "крупная отрасль": "сантехника", "диапазон численности персонала": "1000-4999", "количество сотрудников": 2500, "анализ": "Это хорошо зарекомендовавшая себя компания с иностранными инвестициями...", "информация о риске": { "уровень риска": "низкий", "ownRiskTotal": 0, "associatedRiskTotal": 2, "categories": [...] }, "staffList": [...], "shareHolderList": [...], "branchList": [...], "lawSuitList": [...], "changeList": [...], "translation_complete": 1, "_credits": 95, "_already_purchased": false }

Поля ответа

Основная информация

Поле Тип Описание
имя нить Китайское название компании
зарегистрированное_английское_имя нить Официальное зарегистрированное английское название
кредитный код нить USCC (18 символов)
regStatus нить Статус регистрации (например, Активна, Отменена)
regStatus_interpretation нить Разъяснение статуса регистрации
estiblishTime нить дата основания компании
возраст_компании_лет нить Возраст компании в годах
процентиль нить Показатель надежности компании (0-100%)

Финансовая информация

Поле Тип Описание
regCapital нить Уставный капитал
фактическаяСтолица нить Фактический оплаченный капитал

Местоположение и контактная информация

Поле Тип Описание
город нить Город (перевод)
база нить Провинция/регион (перевод)
округ нить Округ
regLocation нить Зарегестрированный адрес
номер телефона нить Контактный номер телефона
электронная почта нить Контактный адрес электронной почты
веб-сайт нить Веб-сайт компании

Деловая информация

Поле Тип Описание
тип компании нить Тип организации компании
сфера деятельности нить Описание сферы деятельности компании
IndustryMain нить Основная отраслевая категория
IndustryBig нить Основная категория отрасли
IndustryMiddle нить Средняя отраслевая категория
ПромышленностьМалые нить Небольшая отраслевая категория
staffNumRange нить Диапазон количества сотрудников
socialStaffNum целое число работники, зарегистрированные в системе социального страхования
legalPersonName нить Имя законного представителя
тип юридического лица нить Тип законного представителя (физическое лицо/компания)

Оценка риска

Поле Тип Описание
risk_info объект Комплексные данные оценки рисков
анализ нить Анализ компаний, созданный с помощью ИИ

Списки (массивы)

Поле Тип Описание
список сотрудников множество Ключевые сотрудники и руководители
shareHolderList множество Акционеры и структура собственности
branchList множество Филиалы
investList множество Инвестиции в другие компании
lawSuitList множество Судебные дела и иски
судОбъявлениеСписок множество Объявления суда
нечестныйСписок множество Недобросовестные записи о должниках
аномальныйСписок множество аномалии в бизнесе
список изменений множество Компания меняет историю
historyNameList множество Предыдущие названия компаний

Метаданные

Поле Тип Описание
translation_complete целое число Статус перевода (0 = в процессе, 1 = завершен)
_кредиты целое число Остаток вашего кредитного баланса
_уже_куплено логический Был ли этот отчет приобретен ранее?

Расходы

1 кредит за каждую уникальную компанию (USCC). Последующие звонки в ту же компанию USCC бесплатны.

Ответы об ошибках

Статус Код Описание
400 missing_uscc Отсутствующий USCC параметр
400 no_wallet У пользователя не настроен кошелек.
401 missing_api_key API-ключ не предоставлен.
402 недостаточные_кредиты Недостаточно кредитов для покупки отчета.
403 invalid_api_key Недействительный ключ API

Примечания

  • Данные кэшируются на 180 дней – последующие запросы возвращают кэшированные данные без дополнительных затрат на API.
  • Первый запрос может занять больше времени, так как данные извлекаются из источника.
  • Проверять translation_complete поле – если 0, Некоторые поля могут по-прежнему быть на китайском языке.
  • Использовать getTranslationStatus опросить о завершении перевода
  • The _уже_куплено В этом поле указывается, был ли этот звонок платным или бесплатным (ранее оплаченным).

Получение статуса перевода (конечная точка)

Проверьте статус перевода отчета компании. Отчеты автоматически переводятся с китайского на английский после запроса.

Запрос

GET /wp-json/chinacheckup/v1/getTranslationStatus

Аутентификация

Метод Пример
Заголовок (предпочтительный) X-API-Key: ваш-API-ключ
Параметр запроса ?token=your-api-key

Параметры

Параметр Тип Необходимый Описание
USCC нить Да Компания USCC (Единый кодекс социального кредита)

Пример запроса

GET /wp-json/chinacheckup/v1/getTranslationStatus?uscc=91110000625910848Y Header: X-API-Key: YOUR_API_KEY

Ответ

{ "uscc": "91110000625910848Y", "translation_complete": 1, "status": "complete" }

Поля ответа

Поле Тип Описание
USCC нить Запрашиваемая компания USCC
translation_complete целое число Код состояния перевода (см. ниже)
статус нить удобочитаемый статус

Коды статуса перевода

Код Статус Описание
0 в ходе выполнения Перевод находится в процессе или ожидается.
1 полный Перевод завершен – отчет готов.
2 в ходе выполнения Проверено, но не завершено – обработка продолжается.

Расходы

Бесплатно (0 кредитов) – Проверка статуса перевода бесплатна.

Ответы об ошибках

Статус Код Описание
400 missing_uscc Отсутствующий USCC параметр
401 missing_api_key API-ключ не предоставлен.
403 invalid_api_key Недействительный ключ API

Примечания

  • Если компания ранее не запрашивалась, эта конечная точка запустит первоначальную загрузку данных.
  • Перевод обычно завершается за несколько минут.
  • Опрашивайте этот адрес электронной почты, чтобы узнать, когда отчет будет готов к просмотру.
  • Один раз translation_complete является 1, Отчет полностью переведен и готов.

Типичный рабочий процесс

  1. Вызов получитьПолный или getBasic запросить отчет компании
  2. Голосование getTranslationStatus каждые 30-60 секунд
  3. Когда статус является ""полный"", Переведённый отчёт готов.
  4. Вызов получитьПолный снова, чтобы получить полностью переведенные данные.