Point de terminaison de recherche

Recherchez des entreprises chinoises par nom, nom anglais ou numéro de licence commerciale (USCC).

Demande

GET /wp-json/chinacheckup/v1/search

Authentification

Méthode Exemple
En-tête (préférable) Clé API X : votre-clé-API
Paramètre de requête ?token=votre-clé-API

Paramètres

Paramètre Taper Requis Description
termes de recherche chaîne Oui Nom de l'entreprise (en chinois ou en anglais) ou USCC
page_actuelle entier Non Numéro de page pour la pagination (par défaut : 1)

Exemple de requête

GET /wp-json/chinacheckup/v1/search?search_terms=toto&current_page=1 En-tête : X-API-Key : VOTRE_CLÉ_API

Réponse

{ "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": "Company" }, "2344995451": { "name": "南京东陶有限公司", "creditCode": "91320115608929125H", "ville": "Nanjing", "base": "江苏", "registered_english_name": "Nanjing TOTO Co.,Ltd.", "auto_english_name": "", "companyType": 1, "companyTypeText": "Company" } } }

Champs de réponse

Champ Taper Description
résultats_total entier Nombre total d'entreprises correspondantes
page_actuelle chaîne numéro de page actuel
liste d'entreprises objet Carte des identifiants d'entreprise → données de l'entreprise

Objet de l'entreprise

Champ Taper Description
nom chaîne Nom de l'entreprise chinoise
code de crédit chaîne USCC (Code unifié de crédit social) – 18 caractères
ville chaîne Nom de la ville (traduit en anglais)
base chaîne Province/région (chinois)
nom_anglais_enregistré chaîne Nom officiel enregistré en anglais (le cas échéant)
auto_anglais_name chaîne Nom anglais traduit automatiquement (si aucun nom officiel n'est disponible)
type d'entreprise entier Code de type d'entreprise (1 = Entreprise, 2 = Personne)
typedetexte de l'entreprise chaîne Étiquette de type d'entreprise

Coût

Gratuit (0 crédits) – Enregistré à des fins de suivi.

Réponses d'erreur

Statut Code Description
400 termes_manquants Manquant termes de recherche paramètre
400 pas de portefeuille L'utilisateur n'a pas de portefeuille configuré.
401 clé_API_manquante Aucune clé API fournie
403 clé_API_invalide Clé API invalide

Notes

  • Affiche jusqu'à 5 résultats par page
  • Utiliser code de crédit (USCC) pour la suite obtenirBasic ou obtenirComplet appels
  • Les entreprises sans code de crédit ou ville il est impossible de demander des rapports détaillés

Point de terminaison pour obtenir les données complètes de l'entreprise

Obtenez des informations complètes sur l'entreprise, notamment les détails d'enregistrement, les données commerciales, les dossiers judiciaires, l'évaluation des risques et l'analyse basée sur l'IA.

Demande

GET /wp-json/chinacheckup/v1/getFull

Authentification

Méthode Exemple
En-tête (préférable) Clé API X : votre-clé-API
Paramètre de requête ?token=votre-clé-API

Paramètres

Paramètre Taper Requis Description
USCC chaîne Oui USCC (Unified Social Credit Code) de la société – 18 caractères

Exemple de requête

GET /wp-json/chinacheckup/v1/getFull?uscc=91110000625910848Y En-tête : X-API-Key : VOTRE_CLÉ_API

Réponse

{ "name": "东陶(中国)有限公司", "registered_english_name": "Dongtao (China) Co., Ltd.", "creditCode": "91110000625910848Y", "regStatus": "Active", "regStatus_interpretation": "Ce statut indique que la société existe et est en activité.", "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 (Foreign Investment)", "city": "Beijing", "base" : "Beijing", "district" : "Chaoyang", "regLocation" : "N° 123, rue Example, district de Chaoyang, Pékin", "businessScope" : "Fabrication et vente d'articles sanitaires...", "legalPersonName" : "Zhang Wei", "legalPersonType" : "Personne physique", "phoneNumber" : "010-12345678", "email" : "contact@example.com", "website" : "www.example.com", "IndustryMain" : "Fabrication", "IndustryBig" : "Articles sanitaires", "staffNumRange" : "1000-4999", "socialStaffNum" : 2500, "analysis" : "Il s'agit d'une entreprise à capitaux étrangers bien établie...", "risk_info" : { "riskLevel" : "faible", "ownRiskTotal" : 0, "associatedRiskTotal" : 2, "categories" : [...] }, "staffList": [...], "shareHolderList": [...], "branchList": [...], "lawSuitList": [...], "changeList": [...], "translation_complete": 1, "_credits": 95, "_already_purchased": false }

Champs de réponse

Informations de base

Champ Taper Description
nom chaîne Nom de l'entreprise chinoise
nom_anglais_enregistré chaîne Nom officiel enregistré en anglais
code de crédit chaîne USCC (18 caractères)
statut d'enregistrement chaîne Statut de l'inscription (ex. : Active, Annulée)
regStatus_interpretation chaîne Explication du statut d'enregistrement
temps d'établissement chaîne date de création de l'entreprise
âge_de_l'entreprise_années chaîne Âge de l'entreprise en années
score percentile chaîne Score de fiabilité de l'entreprise (0-100%)

Informations financières

Champ Taper Description
regCapital chaîne Capital social
capital réel chaîne Capital versé réel

Localisation et contact

Champ Taper Description
ville chaîne Ville (traduit)
base chaîne Province/région (traduit)
district chaîne District
regLocation chaîne Adresse enregistrée
numéro de téléphone chaîne Numéro de téléphone de contact
e-mail chaîne Adresse e-mail
site web chaîne Site web de l'entreprise

Informations sur l'entreprise

Champ Taper Description
type d'organisation de l'entreprise chaîne Type d'organisation de l'entreprise
portée commerciale chaîne Description du périmètre d'activité
Industrie Principal chaîne Principale catégorie industrielle
IndustrieBig chaîne Catégorie majeure de l'industrie
Secteur intermédiaire chaîne Catégorie intermédiaire de l'industrie
IndustriePetite chaîne Catégorie mineure de l'industrie
StaffNumRange chaîne Nombre d'employés
socialStaffNum entier employés inscrits à l'assurance sociale
Nom de la personne légale chaîne Nom du représentant légal
Type de personne légale chaîne Type de représentant légal (Personne/Société)

L'évaluation des risques

Champ Taper Description
informations sur les risques objet données d'évaluation complète des risques
analyse chaîne Analyse d'entreprise générée par l'IA

Listes (Tableaux)

Champ Taper Description
liste du personnel tableau Personnel clé et cadres supérieurs
Liste des actionnaires tableau Structure des actionnaires et de la propriété
liste de branches tableau succursales
investirListe tableau Investissements dans d'autres sociétés
loiSuitList tableau Affaires juridiques et poursuites judiciaires
tribunalAnnonceListe tableau Annonces du tribunal
malhonnêteListe tableau Registres de débiteurs malhonnêtes
liste anormale tableau Anomalies commerciales
Liste de modifications tableau Historique des changements d'entreprise
liste des noms de l'historique tableau Anciens noms de l'entreprise

Métadonnées

Champ Taper Description
traduction_terminée entier État de la traduction (0 = en cours, 1 = terminée)
_crédits entier Votre solde créditeur restant
déjà_acheté booléen Ce rapport a-t-il été acheté précédemment ?

Coût

1 crédit par compagnie unique (USCC). Les appels suivants pour la même USCC sont gratuits.

Réponses d'erreur

Statut Code Description
400 uscc manquant Manquant USCC paramètre
400 pas de portefeuille L'utilisateur n'a pas de portefeuille configuré.
401 clé_API_manquante Aucune clé API fournie
402 crédits insuffisants Crédits insuffisants pour acheter le rapport
403 clé_API_invalide Clé API invalide

Notes

  • Les données sont mises en cache pendant 180 jours – les appels suivants renvoient les données mises en cache sans frais d'API supplémentaires
  • Le premier appel peut prendre plus de temps, car les données sont récupérées depuis la source.
  • Vérifier traduction_terminée champ – si 0, Certains champs peuvent encore être en chinois
  • Utiliser obtenirStatutDeTraduction sondage pour l'achèvement de la traduction
  • Le déjà_acheté Ce champ indique si cet appel était payant ou gratuit (achat antérieur).

Point de terminaison pour obtenir l'état de la traduction

Vérifiez l'état de la traduction d'un rapport d'entreprise. Les rapports sont automatiquement traduits du chinois vers l'anglais après leur demande.

Demande

GET /wp-json/chinacheckup/v1/getTranslationStatus

Authentification

Méthode Exemple
En-tête (préférable) Clé API X : votre-clé-API
Paramètre de requête ?token=votre-clé-API

Paramètres

Paramètre Taper Requis Description
USCC chaîne Oui Société USCC (Code unifié de crédit social)

Exemple de requête

GET /wp-json/chinacheckup/v1/getTranslationStatus?uscc=91110000625910848Y En-tête : X-API-Key : VOTRE_CLÉ_API

Réponse

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

Champs de réponse

Champ Taper Description
USCC chaîne La société demandée USCC
traduction_terminée entier Code d'état de la traduction (voir ci-dessous)
statut chaîne État lisible par l'homme

Codes d'état de la traduction

Code Statut Description
0 en cours La traduction est en cours ou en attente.
1 complet La traduction est terminée – le rapport est prêt
2 en cours Vérifié mais incomplet – en cours de traitement

Coût

Gratuit (0 crédits) – Vérification de l'état de la traduction gratuite.

Réponses d'erreur

Statut Code Description
400 uscc manquant Manquant USCC paramètre
401 clé_API_manquante Aucune clé API fournie
403 clé_API_invalide Clé API invalide

Notes

  • Si l'entreprise n'a jamais été sollicitée, ce point de terminaison déclenchera la récupération initiale des données.
  • La traduction s'effectue généralement en quelques minutes.
  • Interrogez ce point de terminaison pour vérifier quand un rapport est prêt à être consulté.
  • Une fois traduction_terminée est 1, Le rapport est entièrement traduit et prêt.

Flux de travail typique

  1. Appel obtenirComplet ou obtenirBasic demander un rapport d'entreprise
  2. Sondage obtenirStatutDeTraduction toutes les 30 à 60 secondes
  3. Quand statut est ""complet"", le rapport traduit est prêt
  4. Appel obtenirComplet à nouveau pour récupérer les données entièrement traduites