Endpoint di ricerca

Cerca aziende cinesi per nome, nome in inglese o numero di licenza commerciale (USCC).

Richiesta

GET /wp-json/chinacheckup/v1/search

Autenticazione

Metodo Esempio
Intestazione (preferita) X-API-Key: la tua chiave API
Parametro di query ?token=la-tua-chiave-api

Parametri

Parametro Tipo Necessario Descrizione
termini_di_ricerca corda Nome dell'azienda (cinese o inglese) o USCC
pagina_corrente intero NO Numero di pagina per la paginazione (predefinito: 1)

Esempio di richiesta

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

Risposta

{ "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", "città": "Nanjing", "base": "江苏", "registered_english_name": "Nanjing TOTO Co.,Ltd.", "auto_english_name": "", "companyType": 1, "companyTypeText": "Company" } } }

Campi di risposta

Campo Tipo Descrizione
risultati_totali intero Numero totale di aziende corrispondenti
pagina_corrente corda Numero di pagina corrente
elenco dei soci oggetto Mappa dell'ID azienda → dati aziendali

Oggetto aziendale

Campo Tipo Descrizione
nome corda Nome dell'azienda cinese
Codice di credito corda USCC (Codice Unificato di Credito Sociale) – 18 caratteri
città corda Nome della città (tradotto in inglese)
base corda Provincia/regione (cinese)
nome_inglese_registrato corda Nome ufficiale registrato in inglese (se presente)
nome_automatico_inglese corda Nome inglese tradotto automaticamente (se non esiste un nome ufficiale)
tipo di azienda intero Codice tipo di azienda (1 = Azienda, 2 = Persona fisica)
tipo di azienda corda Etichetta tipo di azienda

Costo

Gratuito (0 crediti) – Registrato a scopo di tracciamento.

Risposte di errore

Stato Codice Descrizione
400 termini mancanti Mancante termini_di_ricerca parametro
400 nessun portafoglio L'utente non ha configurato alcun portafoglio.
401 chiave API mancante Nessuna chiave API fornita
403 chiave API non valida Chiave API non valida

Note

  • Restituisce fino a 5 risultati per pagina
  • Utilizzo Codice di credito (USCC) per il successivo getBasic O ottenere completo chiamate
  • Aziende senza un Codice di credito O città non è possibile richiedere report dettagliati

Ottieni l'endpoint completo dei dati aziendali

Recupera informazioni aziendali complete, inclusi dettagli di registrazione, dati commerciali, precedenti giudiziari, valutazione del rischio e analisi basate sull'intelligenza artificiale.

Richiesta

GET /wp-json/chinacheckup/v1/getFull

Autenticazione

Metodo Esempio
Intestazione (preferita) X-API-Key: la tua chiave API
Parametro di query ?token=la-tua-chiave-api

Parametri

Parametro Tipo Necessario Descrizione
USCC corda Codice USCC (Unified Social Credit Code) dell'azienda – 18 caratteri

Esempio di richiesta

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

Risposta

{ "name": "东陶(中国)有限公司", "registered_english_name": "Dongtao (China) Co., Ltd.", "creditCode": "91110000625910848Y", "regStatus": "Active", "regStatus_interpretation": "Questo stato indica che la società esiste ed è operativa.", "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 Investimento)", "città": "Pechino", "base": "Pechino", "distretto": "Chaoyang", "posizione di registrazione": "No. 123 Example Road, distretto di Chaoyang, Pechino", "ambito di attività": "Produzione e vendita di articoli sanitari...", "nome della persona legale": "Zhang Wei", "tipo di persona legale": "Persona", "numero di telefono": "010-12345678", "email": "contact@example.com", "sito web": "www.example.com", "settore principale": "produzione", "grande settore": "articoli sanitari", "intervallo di numero di dipendenti": "1000-4999", "numero di dipendenti social": 2500, "analisi": "Questa è un'azienda ben consolidata a capitale estero...", "informazioni_sul_rischio": { "livello_di_rischio": "basso", "rischio_proprio_totale": 0, "associatedRiskTotal": 2, "categories": [...] }, "staffList": [...], "shareHolderList": [...], "branchList": [...], "lawSuitList": [...], "changeList": [...], "translation_complete": 1, "_credits": 95, "_already_purchased": false }

Campi di risposta

Informazioni di base

Campo Tipo Descrizione
nome corda Nome dell'azienda cinese
nome_inglese_registrato corda Nome inglese ufficiale registrato
Codice di credito corda USCC (18 caratteri)
regStatus corda Stato della registrazione (ad es. Attiva, Annullata)
interpretazione_regStatus corda Spiegazione dello stato di registrazione
estibnishTime corda Data di costituzione dell'azienda
età_azienda_in_anni corda Età dell'azienda in anni
punteggio percentile corda Punteggio di affidabilità aziendale (0-100%)

Informazioni finanziarie

Campo Tipo Descrizione
regCapital corda Capitale sociale
capitale effettivo corda Capitale versato effettivo

Posizione e contatti

Campo Tipo Descrizione
città corda Città (tradotta)
base corda Provincia/regione (tradotto)
quartiere corda Quartiere
regLocation corda Indirizzo registrato
numero di telefono corda Numero di telefono di contatto
e-mail corda Indirizzo email di contatto
sito web corda Sito web aziendale

Informazioni sull'unità

Campo Tipo Descrizione
tipo di organizzazione aziendale corda Tipo di organizzazione aziendale
ambito aziendale corda Descrizione dell'ambito aziendale
Settore principale corda Categoria industriale principale
Grande industria corda categoria principale del settore
Industria di fascia media corda categoria intermedia del settore
IndustrySmall corda categoria minore dell'industria
Intervallo di numeri del personale corda intervallo di conteggio dei dipendenti
socialStaffNum intero dipendenti iscritti all'assicurazione sociale
nomePersonaLegale corda Nome del rappresentante legale
Tipo di persona legale corda Tipo di rappresentante legale (persona fisica/società)

Valutazione del rischio

Campo Tipo Descrizione
informazioni_sul_rischio oggetto Dati completi sulla valutazione del rischio
analisi corda Analisi aziendale generata dall'intelligenza artificiale

Liste (Array)

Campo Tipo Descrizione
Elenco del personale vettore Personale chiave e dirigenti
Elenco degli azionisti vettore Azionisti e struttura proprietaria
ramificazione vettore Uffici di filiale
investList vettore Investimenti in altre società
Elenco delle cause legali vettore Casi legali e cause giudiziarie
Elenco annunci del tribunale vettore Comunicazioni del tribunale
lista disonesta vettore Registri dei debitori disonesti
Elenco anomalo vettore Anomalie aziendali
changeList vettore La storia cambia azienda
historyNameList vettore Nomi precedenti dell'azienda

Metadati

Campo Tipo Descrizione
traduzione_completata intero Stato della traduzione (0 = in corso, 1 = completata)
crediti intero Il tuo saldo di credito residuo
già acquistato booleano Se questo rapporto è stato precedentemente acquistato

Costo

1 credito per singola azienda (USCC). Le chiamate successive allo stesso USCC sono gratuite.

Risposte di errore

Stato Codice Descrizione
400 mancante_USCC Mancante USCC parametro
400 nessun portafoglio L'utente non ha configurato alcun portafoglio.
401 chiave API mancante Nessuna chiave API fornita
402 crediti insufficienti Crediti insufficienti per acquistare il report
403 chiave API non valida Chiave API non valida

Note

  • I dati vengono memorizzati nella cache per 180 giorni: le chiamate successive restituiscono i dati memorizzati nella cache senza costi API aggiuntivi.
  • La prima chiamata potrebbe richiedere più tempo poiché i dati vengono recuperati dalla fonte
  • Controllo traduzione_completata campo – se 0, alcuni campi potrebbero essere ancora in cinese
  • Utilizzo getTranslationStatus per sondare il completamento della traduzione
  • IL già acquistato Il campo indica se la chiamata è stata a pagamento o gratuita (precedentemente acquistata).

Ottieni l'endpoint sullo stato della traduzione

Verifica lo stato di traduzione di un report aziendale. I report vengono tradotti automaticamente dal cinese all'inglese su richiesta.

Richiesta

GET /wp-json/chinacheckup/v1/getTranslationStatus

Autenticazione

Metodo Esempio
Intestazione (preferita) X-API-Key: la tua chiave API
Parametro di query ?token=la-tua-chiave-api

Parametri

Parametro Tipo Necessario Descrizione
USCC corda Codice USCC (Unified Social Credit Code) dell'azienda

Esempio di richiesta

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

Risposta

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

Campi di risposta

Campo Tipo Descrizione
USCC corda La società richiesta USCC
traduzione_completata intero Codice di stato della traduzione (vedi sotto)
stato corda stato leggibile dall'uomo

Codici di stato della traduzione

Codice Stato Descrizione
0 in corso La traduzione è in sospeso o in corso
1 completare La traduzione è completa, il report è pronto.
2 in corso Verificato ma incompleto – ancora in fase di elaborazione.

Costo

Gratuito (0 crediti) – Nessun costo per la verifica dello stato della traduzione.

Risposte di errore

Stato Codice Descrizione
400 mancante_USCC Mancante USCC parametro
401 chiave API mancante Nessuna chiave API fornita
403 chiave API non valida Chiave API non valida

Note

  • Se l'azienda non è mai stata richiesta, questo endpoint attiverà il recupero iniziale dei dati
  • La traduzione in genere si completa in pochi minuti.
  • Interroga questo endpoint per verificare quando un report è pronto per la visualizzazione.
  • Una volta traduzione_completata È 1, il rapporto è completamente tradotto e pronto

Flusso di lavoro tipico

  1. Chiamata ottenere completo O getBasic richiedere un report aziendale
  2. Sondaggio getTranslationStatus ogni 30-60 secondi
  3. Quando stato È ""completare"", il rapporto tradotto è pronto
  4. Chiamata ottenere completo di nuovo per recuperare i dati completamente tradotti