توثيق واجهة برمجة التطبيقات

نقطة نهاية البحث

ابحث عن الشركات الصينية بالاسم، أو الاسم الإنجليزي، أو رقم رخصة العمل (USCC).

طلب

GET /wp-json/chinacheckup/v1/search

المصادقة

طريقة	مثال
العنوان (مفضل)	`X-API-Key: your-api-key`
معلمات الاستعلام	`?token=your-api-key`

حدود

المعلمة	يكتب	مطلوب	وصف
`مصطلحات البحث`	خيط	نعم	اسم الشركة (بالصينية أو الإنجليزية) أو USCC
`الصفحة الحالية`	عدد صحيح	لا	رقم الصفحة للترقيم (الافتراضي: 1)

مثال على الطلب

طلب GET /wp-json/chinacheckup/v1/search?search_terms=toto&current_page=1 العنوان: X-API-Key: YOUR_API_KEY

إجابة

{ "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"، "المدينة": "نانجينغ"، "الأساس": "جيانغسو"، "الاسم الإنجليزي المسجل": "شركة نانجينغ توتو المحدودة"، "الاسم الإنجليزي التلقائي": ""، "نوع الشركة": 1، "نص نوع الشركة": "شركة" } } }

حقول الاستجابة

مجال	يكتب	وصف
`النتائج الإجمالية`	عدد صحيح	إجمالي عدد الشركات المطابقة
`الصفحة الحالية`	خيط	رقم الصفحة الحالية
`قائمة الشركات`	هدف	خريطة معرف الشركة ← بيانات الشركة

هدف الشركة

مجال	يكتب	وصف
`اسم`	خيط	اسم الشركة الصينية
`رمز الائتمان`	خيط	رمز الائتمان الاجتماعي الموحد (USCC) – 18 حرفًا
`مدينة`	خيط	اسم المدينة (مترجم إلى الإنجليزية)
`قاعدة`	خيط	المقاطعة/المنطقة (بالصينية)
`الاسم الإنجليزي المسجل`	خيط	الاسم الإنجليزي المسجل الرسمي (إن وجد)
`auto_english_name`	خيط	الاسم الإنجليزي المترجم تلقائياً (في حال عدم وجود اسم رسمي)
`نوع الشركة`	عدد صحيح	رمز نوع الشركة (1 = شركة، 2 = شخص)
`نوع الشركة`	خيط	تصنيف نوع الشركة

يكلف

حر (0 رصيد) – تم التسجيل لأغراض التتبع.

ردود الأخطاء

حالة	شفرة	وصف
400	`المصطلحات المفقودة`	مفتقد `مصطلحات البحث` المعلمة
400	`no_wallet`	لم يقم المستخدم بإعداد محفظة.
401	`مفتاح API مفقود`	لم يتم توفير مفتاح API
403	`مفتاح API غير صالح`	مفتاح API غير صالح

ملحوظات

يعرض ما يصل إلى 5 نتائج في الصفحة الواحدة
يستخدم رمز الائتمان (USCC) لللاحق احصل على الأساسيات أو احصل على كامل المكالمات
الشركات التي لا تملك رمز الائتمان أو مدينة لا يمكن الاستعلام عن التقارير التفصيلية

الحصول على بيانات الشركة الكاملة من نقطة النهاية

استرجع معلومات شاملة عن الشركة بما في ذلك تفاصيل التسجيل، وبيانات الأعمال، والسجلات القضائية، وتقييم المخاطر، والتحليل المدعوم بالذكاء الاصطناعي.

طلب

GET /wp-json/chinacheckup/v1/getFull

المصادقة

طريقة	مثال
العنوان (مفضل)	`X-API-Key: your-api-key`
معلمات الاستعلام	`?token=your-api-key`

حدود

المعلمة	يكتب	مطلوب	وصف
`USCC`	خيط	نعم	رمز الائتمان الاجتماعي الموحد للشركة (USCC) – 18 حرفًا

مثال على الطلب

طلب GET /wp-json/chinacheckup/v1/getFull?uscc=91110000625910848Y العنوان: X-API-Key: YOUR_API_KEY

إجابة

{ "name": "شركة دونغتاو (الصين) المحدودة", "registered_english_name": "شركة دونغتاو (الصين) المحدودة.", "creditCode": "91110000625910848Y", "regStatus": "نشطة", "regStatus_interpretation": "تشير هذه الحالة إلى أن الشركة موجودة وتعمل.", "estiblishTime": "1995-08-18", "estiblishTime_formatted": "1995-08-18", "company_age_years": "29", "percentileScore": "85%", "regCapital": "50,000,000 دولار أمريكي", "actualCapital": "50,000,000 دولار أمريكي", "companyOrgType": "شركة ذات مسؤولية محدودة" (استثمار أجنبي)، "المدينة": "بكين"، "القاعدة": "بكين"، "المنطقة": "تشاويانغ"، "موقع التسجيل": "رقم 123 طريق إكزامبل، منطقة تشاويانغ، بكين"، "نطاق العمل": "تصنيع وبيع الأدوات الصحية..."، "اسم الشخص القانوني": "تشانغ وي"، "نوع الشخص القانوني": "شخص"، "رقم الهاتف": "010-12345678"، "البريد الإلكتروني": "contact@example.com"، "الموقع الإلكتروني": "www.example.com"، "الصناعة الرئيسية": "التصنيع"، "الصناعة الكبيرة": "الأدوات الصحية"، "نطاق عدد الموظفين": "1000-4999"، "عدد الموظفين على وسائل التواصل الاجتماعي": 2500، "التحليل": "هذه شركة راسخة ذات استثمار أجنبي..."، "معلومات المخاطر": { "مستوى المخاطر": "منخفض"، "ownRiskTotal": 0, "associatedRiskTotal": 2, "categories": [...] }, "staffList": [...], "shareHolderList": [...], "branchList": [...], "lawSuitList": [...], "changeList": [...], "translation_complete": 1, "_credits": 95, "_already_purchased": false }

حقول الاستجابة

معلومات أساسية

مجال	يكتب	وصف
`اسم`	خيط	اسم الشركة الصينية
`الاسم الإنجليزي المسجل`	خيط	الاسم الإنجليزي المسجل الرسمي
`رمز الائتمان`	خيط	USCC (18 حرفًا)
`حالة التسجيل`	خيط	حالة التسجيل (مثلاً: نشط، ملغي)
`تفسير حالة التسجيل`	خيط	شرح حالة التسجيل
`وقت التأسيس`	خيط	تاريخ تأسيس الشركة
`عمر الشركة بالسنوات`	خيط	عمر الشركة بالسنوات
`النسبة المئوية`	خيط	درجة موثوقية الشركة (0-100%)

المعلومات المالية

مجال	يكتب	وصف
`رأس المال التنظيمي`	خيط	رأس المال المسجل
`رأس المال الفعلي`	خيط	رأس المال المدفوع فعلياً

الموقع ومعلومات الاتصال

مجال	يكتب	وصف
`مدينة`	خيط	المدينة (مترجم)
`قاعدة`	خيط	المحافظة/الإقليم (مترجم)
`يصرف`	خيط	يصرف
`موقع التسجيل`	خيط	عنوان مسجل
`رقم التليفون`	خيط	رقم الهاتف للتواصل
`بريد إلكتروني`	خيط	البريد الإلكتروني للتواصل
`موقع إلكتروني`	خيط	موقع الشركة الإلكتروني

معلومات العمل

مجال	يكتب	وصف
`نوع الشركة أو المؤسسة`	خيط	نوع تنظيم الشركة
`نطاق العمل`	خيط	وصف نطاق العمل
`الصناعة الرئيسية`	خيط	الفئة الصناعية الرئيسية
`صناعة ضخمة`	خيط	الفئة الرئيسية للصناعة
`الصناعة المتوسطة`	خيط	الفئة المتوسطة للصناعة
`الصناعة الصغيرة`	خيط	فئة فرعية للصناعة
`نطاق الأرقام`	خيط	نطاق عدد الموظفين
`رقم الموظف الاجتماعي`	عدد صحيح	الموظفون المسجلون في التأمين الاجتماعي
`اسم الشخص القانوني`	خيط	اسم الممثل القانوني
`نوع الشخص القانوني`	خيط	نوع الممثل القانوني (شخص/شركة)

تقييم المخاطر

مجال	يكتب	وصف
`معلومات المخاطر`	هدف	بيانات تقييم المخاطر الشاملة
`تحليل`	خيط	تحليل الشركات باستخدام الذكاء الاصطناعي

القوائم (المصفوفات)

مجال	يكتب	وصف
`قائمة الموظفين`	مصفوفة	كبار الموظفين والمديرين التنفيذيين
`قائمة المساهمين`	مصفوفة	المساهمون وهيكل الملكية
`قائمة الفروع`	مصفوفة	مكاتب الفروع
`قائمة المستثمرين`	مصفوفة	الاستثمارات في شركات أخرى
`قائمة الدعاوى القضائية`	مصفوفة	القضايا والدعاوى القانونية
`قائمة إعلانات المحكمة`	مصفوفة	إعلانات المحكمة
`dishonestList`	مصفوفة	سجلات المدينين غير النزيهين
`قائمة غير طبيعية`	مصفوفة	حالات شاذة في الأعمال
`قائمة التغييرات`	مصفوفة	تاريخ تغييرات الشركة
`قائمة أسماء التاريخ`	مصفوفة	أسماء الشركات السابقة

البيانات الوصفية

مجال	يكتب	وصف
`الترجمة_مكتملة`	عدد صحيح	حالة الترجمة (0 = قيد التقدم، 1 = مكتملة)
`_credits`	عدد صحيح	رصيدك الائتماني المتبقي
`تم شراؤه بالفعل`	منطقي	ما إذا كان هذا التقرير قد تم شراؤه مسبقاً

يكلف

وحدة دراسية واحدة لكل شركة فريدة (USCC). المكالمات اللاحقة لنفس الشركة الفريدة مجانية.

ردود الأخطاء

حالة	شفرة	وصف
400	`مفقود_USCC`	مفتقد `USCC` المعلمة
400	`no_wallet`	لم يقم المستخدم بإعداد محفظة.
401	`مفتاح API مفقود`	لم يتم توفير مفتاح API
402	`رصيد غير كافٍ`	لا توجد أرصدة كافية لشراء التقرير
403	`مفتاح API غير صالح`	مفتاح API غير صالح

ملحوظات

يتم تخزين البيانات مؤقتًا لمدة 180 يومًا – وتُعيد الاستدعاءات اللاحقة البيانات المخزنة مؤقتًا دون تكاليف إضافية لواجهة برمجة التطبيقات.
قد تستغرق المكالمة الأولى وقتًا أطول نظرًا لجلب البيانات من المصدر.
يفحص الترجمة_مكتملة الحقل – إذا 0, قد لا تزال بعض الحقول باللغة الصينية
يستخدم getTranslationStatus لإجراء استطلاع رأي حول اكتمال الترجمة
ال تم شراؤه بالفعل يشير هذا الحقل إلى ما إذا كانت هذه المكالمة مدفوعة الأجر أم مجانية (تم شراؤها مسبقًا).

نقطة نهاية الحصول على حالة الترجمة

تحقق من حالة ترجمة تقرير الشركة. تُترجم التقارير تلقائيًا من الصينية إلى الإنجليزية بعد طلبها.

طلب

GET /wp-json/chinacheckup/v1/getTranslationStatus

المصادقة

طريقة	مثال
العنوان (مفضل)	`X-API-Key: your-api-key`
معلمات الاستعلام	`?token=your-api-key`

حدود

المعلمة	يكتب	مطلوب	وصف
`USCC`	خيط	نعم	شركة USCC (رمز الائتمان الاجتماعي الموحد)

مثال على الطلب

طلب GET /wp-json/chinacheckup/v1/getTranslationStatus?uscc=91110000625910848Y العنوان: X-API-Key: YOUR_API_KEY

إجابة

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

حقول الاستجابة

مجال	يكتب	وصف
`USCC`	خيط	شركة USCC المطلوبة
`الترجمة_مكتملة`	عدد صحيح	رمز حالة الترجمة (انظر أدناه)
`حالة`	خيط	حالة قابلة للقراءة البشرية

رموز حالة الترجمة

شفرة	حالة	وصف
0	`في تَقَدم`	الترجمة قيد الانتظار أو العمل عليها
1	`مكتمل`	اكتملت الترجمة – التقرير جاهز
2	`في تَقَدم`	تمت المراجعة ولكن غير مكتملة - لا تزال قيد المعالجة

يكلف

حر (0 رصيد) – لا توجد رسوم للتحقق من حالة الترجمة.

ردود الأخطاء

حالة	شفرة	وصف
400	`مفقود_USCC`	مفتقد `USCC` المعلمة
401	`مفتاح API مفقود`	لم يتم توفير مفتاح API
403	`مفتاح API غير صالح`	مفتاح API غير صالح

ملحوظات

إذا لم يتم طلب الشركة من قبل، فستؤدي نقطة النهاية هذه إلى بدء عملية جلب البيانات الأولية.
تكتمل الترجمة عادةً في غضون دقائق قليلة
قم باستطلاع هذه النقطة النهائية للتحقق من جاهزية التقرير للعرض.
مرة واحدة الترجمة_مكتملة يكون 1, تمت ترجمة التقرير بالكامل وهو جاهز

سير العمل النموذجي

يتصل احصل على كامل أو احصل على الأساسيات لطلب تقرير عن الشركة
استطلاع رأي getTranslationStatus كل 30-60 ثانية
متى حالة يكون ""مكتمل"", التقرير المترجم جاهز
يتصل احصل على كامل مرة أخرى لاستعادة البيانات المترجمة بالكامل