Sök slutpunkt

Sök efter kinesiska företag efter namn, engelskt namn eller företagslicensnummer (USCC).

Begäran

HÄMTA /wp-json/chinacheckup/v1/search

Autentisering

Metod Exempel
Rubrik (föredraget) X-API-nyckel: din-API-nyckel
Frågeparameter ?token=din-API-nyckel

Parametrar

Parameter Typ Nödvändig Beskrivning
söktermer sträng Ja Företagsnamn (kinesiska eller engelska) eller USCC
aktuell_sida heltal Inga Sidnummer för paginering (standard: 1)

Exempelförfrågan

HÄMTA /wp-json/chinacheckup/v1/search?search_terms=toto&current_page=1 Rubrik: X-API-nyckel: YOUR_API_KEY

Svar

{ "total_results": 649, "current_page": "1", "companylist": { "9295814": { "name": "东陶(中国)有限公司", "creditCode": "9118591006", "Be"y40006", "Be"y:491006" "base": "北京", "registered_english_name": "Dongtao (China) Co., Ltd.", "auto_english_name": "", "companyType": 1, "companyTypeText": "Företag" }, "2344995451": { "name": "南京东陶有限公司", "creditCode": "91320115608929125H", "city": "Nanjing", "base": "江苏", "registered_english_name": "Nanjing TOTO Co.,Ltd.", "auto_english_name": "", "companyType": 1, "companyTypeText": "Företag" } } }

Svarsfält

Fält Typ Beskrivning
totala_resultat heltal Totalt antal matchande företag
aktuell_sida sträng Nuvarande sidnummer
företagslista objekt Karta över företags-ID → företagsdata

Företagsobjekt

Fält Typ Beskrivning
namn sträng kinesiskt företagsnamn
kreditkod sträng USCC (Unified Social Credit Code) – 18 tecken
stad sträng Stadsnamn (översatt till engelska)
bas sträng Provins/region (kinesiska)
registrerat_engelskt_namn sträng Officiellt registrerat engelskt namn (om sådant finns)
auto_english_name sträng Automatiskt översatt engelskt namn (om inget officiellt namn finns)
företagstyp heltal Företagstypkod (1 = Företag, 2 = Person)
företagstypText sträng Företagstypetikett

Kosta

Gratis (0 poäng) – Loggad för spårningsändamål.

Felsvar

Status Koda Beskrivning
400 saknade_termer Saknad söktermer parameter
400 ingen_plånbok Användaren har ingen plånbok konfigurerad
401 saknad_api_nyckel Ingen API-nyckel tillhandahållen
403 ogiltig_api_nyckel Ogiltig API-nyckel

Anteckningar

  • Returnerar upp till 5 resultat per sida
  • Använda kreditkod (USCC) för efterföljande fåBasic eller fåFull samtal
  • Företag utan en kreditkod eller stad kan inte begäras detaljerade rapporter

Hämta fullständiga företagsdata-slutpunkten

Hämta omfattande företagsinformation inklusive registreringsuppgifter, affärsdata, rättsliga register, riskbedömning och AI-driven analys.

Begäran

HÄMTA /wp-json/chinacheckup/v1/getFull

Autentisering

Metod Exempel
Rubrik (föredraget) X-API-nyckel: din-API-nyckel
Frågeparameter ?token=din-API-nyckel

Parametrar

Parameter Typ Nödvändig Beskrivning
uscc sträng Ja Företags USCC (Unified Social Credit Code) – 18 tecken

Exempelförfrågan

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

Svar

{ "name": "China (China) Co., Ltd.", "creditCode": "91110000625910848Y", "regStatus": "Aktiv", "regStatus_interpretation": "Denna status indikerar att företaget existerar och är i drift.", "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": "Aktiebolag (utländska investeringar)", "city": "Peking", "base": "Peking", "district": "Chaoyang", "regLocation": "Nr 123 Example Road, Chaoyang-distriktet, Peking", "businessScope": "Tillverkning och försäljning av sanitetsartiklar...", "legalPersonName": "Zhang Wei", "legalPersonType": "Person", "phoneNumber": "010-12345678", "email": "contact@example.com", "website": "www.example.com", "IndustryMain": "Tillverkning", "IndustryBig": "Sanitetsartiklar", "staffNumRange": "1000-4999", "socialStaffNum": 2500, "analysis": "Detta är ett väletablerat utlandsinvesterat företag...", "risk_info": { "riskLevel": "low", "ownRiskTotal": 0, "associatedRiskTotal": 2, "categories": [...] }, "staffList": [...], "shareHolderList": [...], "branchList": [...], "lawSuitList": [...], "changeList": [...], "translation_complete": 1, "_credits": 95, "_already_purchased": false }

Svarsfält

Grundläggande information

Fält Typ Beskrivning
namn sträng kinesiskt företagsnamn
registrerat_engelskt_namn sträng Officiellt registrerat engelskt namn
kreditkod sträng USCC (18 tecken)
regStatus sträng Registreringsstatus (t.ex. Aktiv, Avbruten)
regStatus_tolkning sträng Förklaring av registreringsstatus
etableraTid sträng Företagets etableringsdatum
företagets_ålder_år sträng Företagets ålder i år
percentilPoäng sträng Företagets tillförlitlighetspoäng (0-100%)

Finansiell information

Fält Typ Beskrivning
regCapital sträng Registrerat kapital
faktisktKapital sträng Faktiskt inbetalt kapital

Plats och kontakt

Fält Typ Beskrivning
stad sträng Stad (översatt)
bas sträng Provins/region (översatt)
distrikt sträng Distrikt
regPlats sträng Registrerad adress
telefonnummer sträng Kontakttelefonnummer
e-post sträng Kontakt-e-postadress
webbplats sträng Företagets webbplats

Företagsinformation

Fält Typ Beskrivning
företagsorganisationstyp sträng Företagsorganisationstyp
affärsomfattning sträng Beskrivning av verksamhetsomfattning
Branschhuvud sträng Huvudsaklig branschkategori
IndustriStor sträng Branschhuvudkategori
BranschMellan sträng Branschens mellankategori
IndustriLiten sträng Bransch mindre kategori
personalNumRange sträng Antal anställda i intervallet
socialPersonalNum heltal Socialförsäkringsregistrerade anställda
juridisk personnamn sträng Namn på juridiskt ombud
juridisk persontyp sträng Typ av juridiskt ombud (Person/Företag)

Riskbedömning

Fält Typ Beskrivning
risk_info objekt Omfattande riskbedömningsdata
analys sträng AI-genererad företagsanalys

Listor (matriser)

Fält Typ Beskrivning
personallista matris Nyckelpersonal och chefer
aktieinnehavarlista matris Aktieägare och ägarstruktur
filiallista matris Filialkontor
investeraList matris Investeringar i andra företag
lagStämningslista matris Rättsfall och stämningar
domstolsmeddelandelista matris Domstolsmeddelanden
oärlig lista matris Oärliga gäldenärsregister
onormallista matris Affärsavvikelser
ändringslista matris Företagsändringars historia
historiaNamnList matris Tidigare företagsnamn

Metadata

Fält Typ Beskrivning
översättning_slutförd heltal Översättningsstatus (0 = pågår, 1 = klar)
_krediter heltal Ditt återstående kreditsaldo
_redan_köpt boolesk Om den här rapporten köptes tidigare

Kosta

1 poäng per unikt företag (USCC). Efterföljande samtal för samma USCC är gratis.

Felsvar

Status Koda Beskrivning
400 saknas_uscc Saknad uscc parameter
400 ingen_plånbok Användaren har ingen plånbok konfigurerad
401 saknad_api_nyckel Ingen API-nyckel tillhandahållen
402 otillräckliga_krediter Inte tillräckligt med krediter för köprapport
403 ogiltig_api_nyckel Ogiltig API-nyckel

Anteckningar

  • Data cachas i 180 dagar – efterföljande anrop returnerar cachas data utan ytterligare API-kostnader
  • Första samtalet kan ta längre tid eftersom data hämtas från källan
  • Kontrollera översättning_slutförd fält – om 0, vissa fält kan fortfarande vara på kinesiska
  • Använda getTranslationStatus att rösta för att få översättningen klar
  • De _redan_köpt fältet anger om detta samtal var debiterat eller gratis (tidigare köpt)

Hämta översättningsstatusslutpunkt

Kontrollera översättningsstatusen för en företagsrapport. Rapporter översätts automatiskt från kinesiska till engelska efter att de har begärts.

Begäran

GET /wp-json/chinacheckup/v1/getÖversättningsstatus

Autentisering

Metod Exempel
Rubrik (föredraget) X-API-nyckel: din-API-nyckel
Frågeparameter ?token=din-API-nyckel

Parametrar

Parameter Typ Nödvändig Beskrivning
uscc sträng Ja Företags USCC (Unified Social Credit Code)

Exempelförfrågan

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

Svar

{ "uscc": "91110000625910848Y", "översättning_komplett": 1, "status": "klar" }

Svarsfält

Fält Typ Beskrivning
uscc sträng Det begärda företaget USCC
översättning_slutförd heltal Översättningsstatuskod (se nedan)
status sträng Läsbar status

Översättningsstatuskoder

Koda Status Beskrivning
0 pågående Översättning väntar eller pågår
1 komplett Översättningen är klar – rapporten är klar
2 pågående Kontrollerad men ofullständig – bearbetas fortfarande

Kosta

Gratis (0 poäng) – Ingen avgift för att kontrollera översättningsstatus.

Felsvar

Status Koda Beskrivning
400 saknas_uscc Saknad uscc parameter
401 saknad_api_nyckel Ingen API-nyckel tillhandahållen
403 ogiltig_api_nyckel Ogiltig API-nyckel

Anteckningar

  • Om företaget aldrig har blivit begärt kommer denna slutpunkt att utlösa den initiala datahämtningen.
  • Översättningen slutförs vanligtvis inom några minuter
  • Avläs denna slutpunkt för att kontrollera när en rapport är redo att visas
  • En gång översättning_slutförd är 1, rapporten är helt översatt och klar

Typiskt arbetsflöde

  1. Samtal fåFull eller fåBasic att begära en företagsrapport
  2. Röstning getTranslationStatus var 30–60:e sekund
  3. När status är ""komplett"", den översatta rapporten är klar
  4. Samtal fåFull igen för att hämta den fullständigt översatta informationen