Haun päätepiste

Hae kiinalaisia yrityksiä nimen, englanninkielisen nimen tai elinkeinolupanumeron (USCC) perusteella.

Pyytää

GET /wp-json/chinacheckup/v1/search

Todennus

Menetelmä Esimerkki
Ylätunniste (suositeltava) X-API-Key: sinun-API-avaimesi
Kyselyparametri ?token=sinun-API-avaimesi

Parametrit

Parametri Tyyppi Pakollinen Kuvaus
hakutermit jono Kyllä Yrityksen nimi (kiinaksi tai englanniksi) tai USCC
nykyinen_sivu kokonaisluku Ei Sivunumero sivutusta varten (oletus: 1)

Esimerkkipyyntö

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

Vastaus

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

Vastauskentät

Ala Tyyppi Kuvaus
kokonaistulokset kokonaisluku Yhteensopivien yritysten kokonaismäärä
nykyinen_sivu jono Nykyinen sivunumero
yritysluettelo esine Yritystunnuksen kartta → yritystiedot

Yritysobjekti

Ala Tyyppi Kuvaus
nimi jono Kiinalaisen yrityksen nimi
luottokoodi jono USCC (yhtenäinen sosiaaliluottokoodi) – 18 merkkiä
kaupunki jono Kaupungin nimi (käännetty englanniksi)
pohja jono Maakunta/alue (kiina)
rekisteröity_englantilainen_nimi jono Virallinen rekisteröity englanninkielinen nimi (jos sellainen on)
auto_englannin_nimi jono Automaattisesti käännetty englanninkielinen nimi (jos virallista nimeä ei ole)
yritystyyppi kokonaisluku Yrityksen tyyppikoodi (1 = Yritys, 2 = Henkilö)
yritystyyppiTeksti jono Yrityksen tyyppimerkintä

Maksaa

Ilmainen (0 krediittiä) – Kirjataan seurantatarkoituksiin.

Virhevastaukset

Status Koodi Kuvaus
400 puuttuvat_termit Puuttuva hakutermit parametri
400 ei_lompakkoa Käyttäjällä ei ole määritettyä lompakkoa
401 puuttuva_api_avain API-avainta ei annettu
403 virheellinen_api_avain Virheellinen API-avain

Muistiinpanoja

  • Palauttaa jopa 5 tulosta sivua kohden
  • Käyttää luottokoodi (USCC) myöhempää käyttöä varten getBasic tai HankiTäysi puhelut
  • Yritykset, joilla ei ole luottokoodi tai kaupunki ei voida hakea yksityiskohtaisia raportteja

Hanki täydellinen yritysdatapäätepiste

Hae kattavat yritystiedot, mukaan lukien rekisteröintitiedot, yritystiedot, rikosrekisteritiedot, riskinarvioinnit ja tekoälypohjaiset analyysit.

Pyytää

GET /wp-json/chinacheckup/v1/getFull

Todennus

Menetelmä Esimerkki
Ylätunniste (suositeltava) X-API-Key: sinun-API-avaimesi
Kyselyparametri ?token=sinun-API-avaimesi

Parametrit

Parametri Tyyppi Pakollinen Kuvaus
USCC jono Kyllä Yrityksen USCC (Unified Social Credit Code) – 18 merkkiä

Esimerkkipyyntö

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

Vastaus

{ "name": "东陶(中国)有限公司", "registered_english_name": "Dongtao (China) Co., Ltd.", "creditCode": "91110000625910848Y", "regStatus": "Aktiivinen", "regStatus_interpretation": "Tämä tila osoittaa, että yritys on olemassa ja toiminnassa.", "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": "Osakeyhtiö (ulkomainen sijoitus)", "city": "Peking", "base": "Peking", "district": "Chaoyang", "regLocation": "No. 123 Example Road, Chaoyangin alue, Peking", "businessScope": "Saniteettituotteiden valmistus ja myynti...", "legalPersonName": "Zhang Wei", "legalPersonType": "Person", "phoneNumber": "010-12345678", "email": "contact@example.com", "website": "www.example.com", "IndustryMain": "Valmistus", "IndustryBig": "Saniteettituotteet", "staffNumRange": "1000-4999", "socialStaffNum": 2500, "analysis": "Tämä on vakiintunut ulkomaisella sijoituksella toimiva yritys...", "risk_info": { "riskLevel": "low", "ownRiskTotal": 0, "associatedRiskTotal": 2, "categories": [...] }, "staffList": [...], "shareHolderList": [...], "branchList": [...], "lawSuitList": [...], "changeList": [...], "translation_complete": 1, "_credits": 95, "_already_purchased": false }

Vastauskentät

Perustiedot

Ala Tyyppi Kuvaus
nimi jono Kiinalaisen yrityksen nimi
rekisteröity_englantilainen_nimi jono Virallinen rekisteröity englanninkielinen nimi
luottokoodi jono USCC (18 merkkiä)
rek. tila jono Rekisteröinnin tila (esim. aktiivinen, peruttu)
rekisterin_tilan_tulkinta jono Rekisteröintitilan selitys
arvioitu aika jono Yrityksen perustamispäivä
yrityksen_ikä_vuotta jono Yrityksen ikä vuosina
prosenttipisteet jono Yrityksen luotettavuuspisteet (0–100%)

Taloudelliset tiedot

Ala Tyyppi Kuvaus
regCapital jono Rekisteröity pääoma
todellinen pääoma jono Todellinen maksettu pääoma

Sijainti ja yhteystiedot

Ala Tyyppi Kuvaus
kaupunki jono Kaupunki (käännetty)
pohja jono Maakunta/alue (käännetty)
piiri jono Kaupunginosa
rek.Sijainti jono Rekisteröity osoite
puhelinnumero jono Yhteyshenkilön puhelinnumero
sähköposti jono Yhteystiedot
verkkosivusto jono Yrityksen verkkosivusto

Yritystiedot

Ala Tyyppi Kuvaus
yritysOrganisaatiotyyppi jono Yrityksen organisaatiotyyppi
businessScope jono Liiketoiminnan laajuuden kuvaus
TeollisuusPääasiallinen jono Päätoimialaluokka
TeollisuusSuuri jono Toimialan pääluokka
TeollisuudenalaKeskitaso jono Teollisuuden keskiluokka
TeollisuudenalaPieni jono Teollisuuden sivukategoria
henkilöstönNumRange jono Työntekijöiden lukumäärän vaihteluväli
sosiaalinenHenkilökuntaNum kokonaisluku Sosiaaliturvan rekisteröimät työntekijät
oikeushenkilön nimi jono Laillisen edustajan nimi
oikeushenkilön tyyppi jono Laillisen edustajan tyyppi (henkilö/yritys)

Riskienarviointi

Ala Tyyppi Kuvaus
riski_tiedot esine Kattavat riskinarviointitiedot
analyysi jono Tekoälyn luoma yritysanalyysi

Listat (taulukot)

Ala Tyyppi Kuvaus
henkilöstöluettelo taulukko Avainhenkilöt ja johto
osakeomistajaluettelo taulukko Osakkeenomistajat ja omistusrakenne
haaraluettelo taulukko Sivukonttorit
sijoituslista taulukko Sijoitukset muihin yrityksiin
Lakihakemuslista taulukko Oikeusjutut ja oikeusjutut
Oikeuden ilmoitusluettelo taulukko Oikeuden ilmoitukset
epärehellinenLista taulukko Epärehelliset velalliset
epänormaaliLista taulukko Liiketoiminnan poikkeavuudet
muutoslista taulukko Yrityksen muutoshistoria
historiaNimiluettelo taulukko Aiemmat yrityksen nimet

Metatiedot

Ala Tyyppi Kuvaus
käännös_valmis kokonaisluku Käännöksen tila (0 = kesken, 1 = valmis)
_krediitit kokonaisluku Jäljellä oleva luottosaldosi
_jo_ostettu totuusarvo Onko tämä raportti aiemmin ostettu

Maksaa

1 luotto yrityskohtainen (USCC). Myöhemmät puhelut samaan USCC:hen ovat ilmaisia.

Virhevastaukset

Status Koodi Kuvaus
400 missing_uscc Puuttuva USCC parametri
400 ei_lompakkoa Käyttäjällä ei ole määritettyä lompakkoa
401 puuttuva_api_avain API-avainta ei annettu
402 riittämättömät_krediitit Ei tarpeeksi krediittejä ostoraportin tekemiseen
403 virheellinen_api_avain Virheellinen API-avain

Muistiinpanoja

  • Data tallennetaan välimuistiin 180 päiväksi – myöhemmät kutsut palauttavat välimuistissa olevan datan ilman lisä-API-kustannuksia
  • Ensimmäinen puhelu voi kestää kauemmin, koska tiedot noudetaan lähteestä
  • Tarkista käännös_valmis kenttä – jos 0, jotkin kentät saattavat edelleen olla kiinaksi
  • Käyttää haeKäännöksen tila kysely käännöksen valmistumisesta
  • The _jo_ostettu kenttä osoittaa, oliko tämä puhelu maksullinen vai ilmainen (aiemmin ostettu)

Hae käännöksen tila -päätepiste

Tarkista yritysraportin käännöstila. Raportit käännetään automaattisesti kiinasta englanniksi pyynnöstä.

Pyytää

GET /wp-json/chinacheckup/v1/getTranslationStatus

Todennus

Menetelmä Esimerkki
Ylätunniste (suositeltava) X-API-Key: sinun-API-avaimesi
Kyselyparametri ?token=sinun-API-avaimesi

Parametrit

Parametri Tyyppi Pakollinen Kuvaus
USCC jono Kyllä Yritys USCC (United Social Credit Code)

Esimerkkipyyntö

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

Vastaus

{ "uscc": "91110000625910848Y", "käännös_valmis": 1, "tila": "valmis" }

Vastauskentät

Ala Tyyppi Kuvaus
USCC jono Pyynnön saanut yritys USCC
käännös_valmis kokonaisluku Käännöksen tilakoodi (katso alla)
status jono Ihmisen luettavissa oleva tila

Käännöstilakoodit

Koodi Status Kuvaus
0 keskeneräinen Käännös on vireillä tai kesken
1 täydellinen Käännös on valmis – raportti on valmis
2 keskeneräinen Tarkistettu, mutta keskeneräinen – käsittely edelleen käynnissä

Maksaa

Ilmainen (0 opintopistettä) – Käännöstilan tarkistaminen on maksutonta.

Virhevastaukset

Status Koodi Kuvaus
400 missing_uscc Puuttuva USCC parametri
401 puuttuva_api_avain API-avainta ei annettu
403 virheellinen_api_avain Virheellinen API-avain

Muistiinpanoja

  • Jos yritystä ei ole koskaan pyydetty, tämä päätepiste käynnistää alkuperäisen tiedonhaun.
  • Käännös valmistuu yleensä muutamassa minuutissa
  • Kysele tätä päätepistettä tarkistaaksesi, milloin raportti on valmis katseltavaksi
  • Kerran käännös_valmis on 1, raportti on täysin käännetty ja valmis

Tyypillinen työnkulku

  1. Soittaa HankiTäysi tai getBasic pyytää yritysraporttia
  2. Kysely haeKäännöksen tila 30–60 sekunnin välein
  3. Kun status on ""täydellinen"", käännetty raportti on valmis
  4. Soittaa HankiTäysi uudelleen hakeaksesi täysin käännetyn datan