Søkesluttpunkt

Søk etter kinesiske selskaper etter navn, engelsk navn eller forretningslisensnummer (USCC).

Forespørsel

FÅ /wp-json/chinacheckup/v1/search

Autentisering

Metode Eksempel
Overskrift (foretrukket) X-API-nøkkel: din-API-nøkkel
Spørringsparameter ?token=din-API-nøkkel

Parametere

Parameter Type Obligatorisk Beskrivelse
søkeord streng Ja Firmanavn (kinesisk eller engelsk) eller USCC
gjeldende_side heltall Ingen Sidetall for paginering (standard: 1)

Eksempelforespørsel

HENT /wp-json/chinacheckup/v1/search?search_terms=toto&current_page=1 Overskrift: X-API-nøkkel: YOUR_API_KEY

Svar

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

Svarfelt

Felt Type Beskrivelse
totale_resultater heltall Totalt antall samsvarende selskaper
gjeldende_side streng Gjeldende sidetall
selskapsliste gjenstand Kart over firma-ID → firmadata

Selskapsobjekt

Felt Type Beskrivelse
navn streng Kinesisk firmanavn
kredittkode streng USCC (Unified Social Credit Code) – 18 tegn
by streng Bynavn (oversatt til engelsk)
base streng Provins/region (kinesisk)
registrert_engelsk_navn streng Offisielt registrert engelsk navn (hvis det finnes et)
auto_engelsk_navn streng Automatisk oversatt engelsk navn (hvis det ikke finnes noe offisielt navn)
selskapstype heltall Firmatypekode (1 = Firma, 2 = Person)
selskapstypetekst streng Firmatypeetikett

Koste

Gratis (0 studiepoeng) – Logget for sporingsformål.

Feilresponser

Status Kode Beskrivelse
400 manglende_termer Savnet søkeord parameter
400 ingen_lommebok Brukeren har ingen konfigurert lommebok
401 manglende_api_nøkkel Ingen API-nøkkel oppgitt
403 ugyldig_api_nøkkel Ugyldig API-nøkkel

Notater

  • Returnerer opptil 5 resultater per side
  • Bruk kredittkode (USCC) for påfølgende fåBasic eller fåFull samtaler
  • Selskaper uten en kredittkode eller by kan ikke forespørres om detaljerte rapporter

Få fullstendige bedriftsdata-sluttpunkter

Hent omfattende selskapsinformasjon, inkludert registreringsdetaljer, forretningsdata, rettslige registre, risikovurdering og AI-drevet analyse.

Forespørsel

FÅ /wp-json/chinacheckup/v1/getFull

Autentisering

Metode Eksempel
Overskrift (foretrukket) X-API-nøkkel: din-API-nøkkel
Spørringsparameter ?token=din-API-nøkkel

Parametere

Parameter Type Obligatorisk Beskrivelse
USCC streng Ja Selskapets USCC (Unified Social Credit Code) – 18 tegn

Eksempelforespørsel

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

Svar

{ "name": "China (China) Co., Ltd.", "registered_english_name": "Dongtao (China) Co., Ltd.", "creditCode": "91110000625910848Y", "regStatus": "Aktiv", "regStatus_interpretation": "Denne statusen indikerer at selskapet eksisterer og er 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": "Aksjeselskap (utenlandsk investering)", "city": "Beijing", "base": "Beijing", "distrikt": "Chaoyang", "regLocation": "Nr. 123 Eksempelvei, Chaoyang-distriktet, Beijing", "businessScope": "Produksjon og salg av sanitærutstyr...", "legalPersonName": "Zhang Wei", "legalPersonType": "Person", "phoneNumber": "010-12345678", "email": "contact@example.com", "website": "www.example.com", "IndustryMain": "Produksjon", "IndustryBig": "Sanitærutstyr", "staffNumRange": "1000-4999", "socialStaffNum": 2500, "analysis": "Dette er et veletablert utenlandsk investert selskap...", "risk_info": { "riskLevel": "low", "ownRiskTotal": 0, "associatedRiskTotal": 2, "categories": [...] }, "staffList": [...], "shareHolderList": [...], "branchList": [...], "lawSuitList": [...], "changeList": [...], "translation_complete": 1, "_credits": 95, "_already_purchased": false }

Svarfelt

Grunnleggende informasjon

Felt Type Beskrivelse
navn streng Kinesisk firmanavn
registrert_engelsk_navn streng Offisielt registrert engelsk navn
kredittkode streng USCC (18 tegn)
regStatus streng Registreringsstatus (f.eks. Aktiv, Avlyst)
regStatus_tolkning streng Forklaring av registreringsstatusen
etablerertid streng Selskapets etableringsdato
company_age_years streng Selskapets alder i år
persentilScore streng Selskapets pålitelighetspoengsum (0–100%)

Finansiell informasjon

Felt Type Beskrivelse
regCapital streng Registrert kapital
faktiskKapital streng Faktisk innbetalt kapital

Sted og kontakt

Felt Type Beskrivelse
by streng By (oversatt)
base streng Provins/region (oversatt)
distrikt streng Distrikt
regLokasjon streng Registrert adresse
telefonnummer streng Kontakt telefonnummer
e-post streng Kontakt-e-postadresse
nettsted streng Selskapets nettsted

Forretningsinformasjon

Felt Type Beskrivelse
selskapOrganisasjonstype streng Bedriftsorganisasjonstype
forretningsomfang streng Beskrivelse av forretningsomfang
Industri Hoved streng Hovedindustrikategori
IndustriStor streng Bransjens hovedkategori
IndustriMidt streng Bransjens mellomkategori
IndustriLiten streng Bransje mindre kategori
ansattNumRange streng Antall ansatte
sosialtAnsattnummer heltall Trygderegistrerte ansatte
juridiskPersonNavn streng Navn på juridisk representant
juridiskPersonType streng Type juridisk representant (Person/Selskap)

Risikovurdering

Felt Type Beskrivelse
risikoinformasjon gjenstand Omfattende risikovurderingsdata
analyse streng AI-generert selskapsanalyse

Lister (matriser)

Felt Type Beskrivelse
medarbeiderliste matrise Nøkkelpersonell og ledere
aksjeEierliste matrise Aksjonærer og eierstruktur
grenliste matrise Avdelingskontorer
investList matrise Investeringer i andre selskaper
lovSøksmålsliste matrise Rettssaker og søksmål
rettsKunngjøringsliste matrise Rettslige kunngjøringer
uærligListe matrise Uærlige skyldnerregistre
unormalListe matrise Forretningsavvik
endringsliste matrise Historien om endringer i selskapet
historieNavnListe matrise Tidligere firmanavn

Metadata

Felt Type Beskrivelse
oversettelse_fullført heltall Oversettelsesstatus (0 = pågår, 1 = fullført)
_kreditter heltall Din gjenværende kredittsaldo
_allerede_kjøpt boolsk Om denne rapporten ble kjøpt tidligere

Koste

1 studiepoeng per unikt selskap (USCC). Etterfølgende samtaler for samme USCC er gratis.

Feilresponser

Status Kode Beskrivelse
400 mangler_uscc Savnet USCC parameter
400 ingen_lommebok Brukeren har ingen konfigurert lommebok
401 manglende_api_nøkkel Ingen API-nøkkel oppgitt
402 utilstrekkelig_kreditt Ikke nok kreditter til kjøpsrapport
403 ugyldig_api_nøkkel Ugyldig API-nøkkel

Notater

  • Dataene blir bufret i 180 dager – påfølgende kall returnerer bufrede data uten ekstra API-kostnader
  • Første anrop kan ta lengre tid ettersom data hentes fra kilden
  • Sjekke oversettelse_fullført felt – hvis 0, noen felt kan fortsatt være på kinesisk
  • Bruk hentOversettelsesstatus å avstemme for fullføring av oversettelsen
  • De _allerede_kjøpt Feltet angir om denne samtalen var belastet eller gratis (tidligere kjøpt)

Hent oversettelsesstatus-sluttpunkt

Sjekk oversettelsesstatusen til en bedriftsrapport. Rapporter oversettes automatisk fra kinesisk til engelsk etter forespørsel.

Forespørsel

GET /wp-json/chinacheckup/v1/getOversettelsesstatus

Autentisering

Metode Eksempel
Overskrift (foretrukket) X-API-nøkkel: din-API-nøkkel
Spørringsparameter ?token=din-API-nøkkel

Parametere

Parameter Type Obligatorisk Beskrivelse
USCC streng Ja Selskapets USCC (Unified Social Credit Code)

Eksempelforespørsel

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

Svar

{ "uscc": "91110000625910848Y", "oversettelse_fullført": 1, "status": "fullført" }

Svarfelt

Felt Type Beskrivelse
USCC streng Det forespurte selskapet USCC
oversettelse_fullført heltall Oversettelsesstatuskode (se nedenfor)
status streng Status for menneskelig lesbar

Oversettelsesstatuskoder

Kode Status Beskrivelse
0 pågår Oversettelsen venter eller pågår
1 fullstendig Oversettelsen er fullført – rapporten er klar
2 pågår Sjekket, men ufullstendig – fortsatt under behandling

Koste

Gratis (0 studiepoeng) – Ingen kostnad for å sjekke oversettelsesstatus.

Feilresponser

Status Kode Beskrivelse
400 mangler_uscc Savnet USCC parameter
401 manglende_api_nøkkel Ingen API-nøkkel oppgitt
403 ugyldig_api_nøkkel Ugyldig API-nøkkel

Notater

  • Hvis selskapet aldri har blitt forespurt, vil dette endepunktet utløse den første datahentingen.
  • Oversettelsen fullføres vanligvis innen få minutter
  • Avles dette endepunktet for å sjekke når en rapport er klar til visning
  • En gang oversettelse_fullført er 1, rapporten er fullstendig oversatt og klar

Typisk arbeidsflyt

  1. Ringe fåFull eller fåBasic å be om en selskapsrapport
  2. Avstemning hentOversettelsesstatus hvert 30.–60. sekund
  3. Når status er ""fullstendig"", den oversatte rapporten er klar
  4. Ringe fåFull igjen for å hente de fullstendig oversatte dataene