Suchendpunkt

Suche nach chinesischen Unternehmen anhand des Namens, des englischen Namens oder der USCC-Handelslizenznummer.

Anfrage

GET /wp-json/chinacheckup/v1/search

Authentifizierung

Verfahren Beispiel
Kopfzeile (bevorzugt) X-API-Schlüssel: Ihr-API-Schlüssel
Abfrageparameter ?token=Ihr-API-Schlüssel

Parameter

Parameter Typ Erforderlich Beschreibung
Suchbegriffe Zeichenkette Ja Firmenname (chinesisch oder englisch) oder USCC
aktuelle Seite ganze Zahl NEIN Seitenzahl für die Seitennummerierung (Standard: 1)

Beispielanfrage

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

Antwort

{ "total_results": 649, "current_page": "1", "companylist": { "9295814": { "name": "东陶(中国)有限公司", "creditCode": "91110000625910848Y", "city": "Peking", "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": "Company" } } }

Antwortfelder

Feld Typ Beschreibung
Gesamtergebnisse ganze Zahl Gesamtzahl der übereinstimmenden Unternehmen
aktuelle Seite Zeichenkette Aktuelle Seitenzahl
Firmenliste Objekt Zuordnung von Firmen-IDs zu Firmendaten

Firmenobjekt

Feld Typ Beschreibung
Name Zeichenkette Chinesischer Firmenname
Gutscheincode Zeichenkette USCC (Unified Social Credit Code) – 18 Zeichen
Stadt Zeichenkette Stadtname (ins Englische übersetzt)
Base Zeichenkette Provinz/Region (Chinesisch)
registrierter_englischer_name Zeichenkette Offizieller eingetragener englischer Name (falls vorhanden)
auto_english_name Zeichenkette Automatisch übersetzter englischer Name (falls kein offizieller Name vorhanden)
Unternehmenstyp ganze Zahl Firmentypcode (1 = Firma, 2 = Person)
firmentyptext Zeichenkette Firmenetikett

Kosten

Frei (0 Credits) – Zu Trackingzwecken protokolliert.

Fehlermeldungen

Status Code Beschreibung
400 fehlende Begriffe Fehlen Suchbegriffe Parameter
400 keine_Geldbörse Dem Benutzer ist keine Wallet konfiguriert.
401 fehlender API-Schlüssel Kein API-Schlüssel bereitgestellt
403 ungültiger API-Schlüssel Ungültiger API-Schlüssel

Anmerkungen

  • Gibt bis zu 5 Ergebnisse pro Seite zurück
  • Verwenden Gutscheincode (USCC) für nachfolgende getBasic oder getFull Anrufe
  • Unternehmen ohne Gutscheincode oder Stadt Detaillierte Berichte können nicht angefordert werden.

Vollständigen Unternehmensdaten-Endpunkt abrufen

Rufen Sie umfassende Unternehmensinformationen ab, einschließlich Registrierungsdetails, Geschäftsdaten, Gerichtsakten, Risikobewertung und KI-gestützter Analyse.

Anfrage

GET /wp-json/chinacheckup/v1/getFull

Authentifizierung

Verfahren Beispiel
Kopfzeile (bevorzugt) X-API-Schlüssel: Ihr-API-Schlüssel
Abfrageparameter ?token=Ihr-API-Schlüssel

Parameter

Parameter Typ Erforderlich Beschreibung
USCC Zeichenkette Ja USCC (Unified Social Credit Code) – 18 Zeichen

Beispielanfrage

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

Antwort

{ "name": "东陶(中国)有限公司", "registered_english_name": "Dongtao (China) Co., Ltd.", "creditCode": "91110000625910848Y", "regStatus": "Aktiv", "regStatus_interpretation": "Dieser Status zeigt an, dass das Unternehmen existiert und operativ tätig ist.", "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": "Gesellschaft mit beschränkter Haftung (ausländische Investition)", "city": "Beijing", "base": "Peking", "Bezirk": "Chaoyang", "Standort": "Nr. 123 Beispielstraße, Bezirk Chaoyang, Peking", "Geschäftsbereich": "Herstellung und Vertrieb von Sanitärartikeln...", "Name der juristischen Person": "Zhang Wei", "Art der juristischen Person": "Person", "Telefonnummer": "010-12345678", "E-Mail": "contact@example.com", "Website": "www.example.com", "Hauptbranche": "Herstellung", "Großbranche": "Sanitärartikel", "Mitarbeiterzahl"": "1000-4999", "Mitarbeiterzahl": 2500, "Analyse": "Dies ist ein etabliertes, ausländisch investiertes Unternehmen...", "Risikoinformationen": { "Risikostufe": "niedrig", "Eigenes Gesamtrisiko": 0, "Zugehöriges Gesamtrisiko": 2, "Kategorien": [...] }, "Mitarbeiterliste": [...], "shareHolderList": [...], "branchList": [...], "lawSuitList": [...], "changeList": [...], "translation_complete": 1, "_credits": 95, "_already_purchased": false }

Antwortfelder

Grundlegende Informationen

Feld Typ Beschreibung
Name Zeichenkette Chinesischer Firmenname
registrierter_englischer_name Zeichenkette Offizieller eingetragener englischer Name
Gutscheincode Zeichenkette USCC (18 Zeichen)
regStatus Zeichenkette Registrierungsstatus (z. B. Aktiv, Storniert)
regStatus_interpretation Zeichenkette Erläuterung des Registrierungsstatus
estiblishTime Zeichenkette Gründungsdatum des Unternehmens
Firmenalter (Jahre) Zeichenkette Firmenalter in Jahren
Perzentilwert Zeichenkette Zuverlässigkeitsbewertung des Unternehmens (0-100%)

Finanzinformationen

Feld Typ Beschreibung
regCapital Zeichenkette Grundkapital
tatsächliches Kapital Zeichenkette Tatsächlich eingezahltes Kapital

Standort & Kontakt

Feld Typ Beschreibung
Stadt Zeichenkette Stadt (übersetzt)
Base Zeichenkette Provinz/Region (übersetzt)
Bezirk Zeichenkette Bezirk
regLocation Zeichenkette Registrierte Adresse
Telefonnummer Zeichenkette Kontakttelefonnummer
E-Mail Zeichenkette Kontakt-E-Mail
Webseite Zeichenkette Unternehmenswebsite

Geschäftsinformationen

Feld Typ Beschreibung
Unternehmensorganisationstyp Zeichenkette Unternehmensorganisationstyp
Geschäftsbereich Zeichenkette Beschreibung des Geschäftsbereichs
Hauptbranche Zeichenkette Hauptbranchenkategorie
Industriegroß Zeichenkette Hauptkategorie der Branche
Industrie Mittel Zeichenkette Mittlere Branche
Kleinindustrie Zeichenkette Branche Nebenkategorie
Mitarbeiterzahlbereich Zeichenkette Mitarbeiterzahlbereich
Sozialmitarbeiternummer ganze Zahl Sozialversicherungspflichtige Mitarbeiter
Name der juristischen Person Zeichenkette Name des gesetzlichen Vertreters
legalPersonType Zeichenkette Art des gesetzlichen Vertreters (Person/Unternehmen)

Risikobewertung

Feld Typ Beschreibung
Risikoinformationen Objekt Daten zur umfassenden Risikobewertung
Analyse Zeichenkette KI-generierte Unternehmensanalyse

Listen (Arrays)

Feld Typ Beschreibung
Mitarbeiterliste Array Schlüsselpersonal und Führungskräfte
Aktionärsliste Array Aktionäre und Eigentümerstruktur
branchenliste Array Zweigstellen
investList Array Investitionen in andere Unternehmen
Klageliste Array Rechtsfälle und Klagen
courtAnnouncementList Array Gerichtsmitteilungen
unehrliche Liste Array Aufzeichnungen über unehrliche Schuldner
abnormalList Array Geschäftsanomalien
Änderungsliste Array Unternehmensgeschichte
historyNameList Array Frühere Firmennamen

Metadaten

Feld Typ Beschreibung
Übersetzung abgeschlossen ganze Zahl Übersetzungsstatus (0 = in Bearbeitung, 1 = abgeschlossen)
_Credits ganze Zahl Ihr verbleibendes Guthaben
_bereits_gekauft boolescher Wert Ob dieser Bericht zuvor erworben wurde

Kosten

1 Kredit pro eindeutigem Unternehmen (USCC). Nachfolgende Anrufe an dasselbe USCC sind kostenlos.

Fehlermeldungen

Status Code Beschreibung
400 missing_uscc Fehlen USCC Parameter
400 keine_Geldbörse Dem Benutzer ist keine Wallet konfiguriert.
401 fehlender API-Schlüssel Kein API-Schlüssel bereitgestellt
402 unzureichendes Guthaben Nicht genügend Guthaben, um den Bericht zu kaufen
403 ungültiger API-Schlüssel Ungültiger API-Schlüssel

Anmerkungen

  • Die Daten werden für 180 Tage zwischengespeichert – nachfolgende Aufrufe liefern die zwischengespeicherten Daten ohne zusätzliche API-Kosten.
  • Der erste Aufruf kann länger dauern, da die Daten aus der Quelle abgerufen werden.
  • Überprüfen Übersetzung abgeschlossen Feld – wenn 0, Einige Felder sind möglicherweise noch auf Chinesisch.
  • Verwenden Übersetzungsstatus abrufen um die Fertigstellung der Übersetzung abzufragen
  • Der _bereits_gekauft Dieses Feld zeigt an, ob dieser Anruf kostenpflichtig oder kostenlos (zuvor erworben) war.

Endpunkt zum Abrufen des Übersetzungsstatus

Prüfen Sie den Übersetzungsstatus eines Unternehmensberichts. Berichte werden nach Anforderung automatisch vom Chinesischen ins Englische übersetzt.

Anfrage

GET /wp-json/chinacheckup/v1/getTranslationStatus

Authentifizierung

Verfahren Beispiel
Kopfzeile (bevorzugt) X-API-Schlüssel: Ihr-API-Schlüssel
Abfrageparameter ?token=Ihr-API-Schlüssel

Parameter

Parameter Typ Erforderlich Beschreibung
USCC Zeichenkette Ja USCC (Unified Social Credit Code)

Beispielanfrage

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

Antwort

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

Antwortfelder

Feld Typ Beschreibung
USCC Zeichenkette Das anfragende Unternehmen USCC
Übersetzung abgeschlossen ganze Zahl Übersetzungsstatuscode (siehe unten)
Status Zeichenkette für Menschen lesbarer Status

Übersetzungsstatuscodes

Code Status Beschreibung
0 im Gange Die Übersetzung ist noch in Bearbeitung oder steht noch aus.
1 vollständig Übersetzung abgeschlossen – Bericht fertig
2 im Gange Geprüft, aber noch nicht abgeschlossen – wird noch bearbeitet

Kosten

Frei (0 Credits) – Kostenlose Überprüfung des Übersetzungsstatus.

Fehlermeldungen

Status Code Beschreibung
400 missing_uscc Fehlen USCC Parameter
401 fehlender API-Schlüssel Kein API-Schlüssel bereitgestellt
403 ungültiger API-Schlüssel Ungültiger API-Schlüssel

Anmerkungen

  • Wenn das Unternehmen noch nie angefordert wurde, löst dieser Endpunkt den ersten Datenabruf aus.
  • Die Übersetzung ist in der Regel innerhalb weniger Minuten abgeschlossen.
  • Fragen Sie diesen Endpunkt regelmäßig ab, um zu prüfen, wann ein Bericht zur Ansicht bereit ist.
  • Einmal Übersetzung abgeschlossen Ist 1, Der Bericht ist vollständig übersetzt und bereit.

Typischer Arbeitsablauf

  1. Anruf getFull oder getBasic einen Unternehmensbericht anfordern
  2. Umfrage Übersetzungsstatus abrufen alle 30-60 Sekunden
  3. Wann Status Ist ""vollständig"", Der übersetzte Bericht ist fertig.
  4. Anruf getFull erneut, um die vollständig übersetzten Daten abzurufen.