الأسئلة الشائعة
إجابات عمّا يسأل عنه المطورون أكثر من غيره.
إجابات قصيرة عن الأسئلة التي يطرحها المطورون أكثر من غيرها. التفاصيل في الصفحة المرتبطة.
البيانات
من أين تأتي البيانات؟
من السجلات والمنشورات الرسمية: السجل التجاري (Handelsregister)، وسجل الشركات (Unternehmensregister) مع القوائم المالية السنوية، وإعلانات الإعسار. أما الأخبار ومحتوى المواقع فتأتي من الويب. المزيد في توفر البيانات.
نقرأ كثيرًا من التفاصيل آليًا من المستندات والإعلانات المنشورة. نستخدم لذلك أحدث التقنيات ونستثمر كثيرًا في الجودة؛ ومع ذلك تبقى أخطاء فردية ممكنة.
ما مدى حداثة البيانات؟
يأتي ملف الشركة من قاعدة بياناتنا. ومع الوقت الفعلي تستعلم الـ API أيضًا من السجل التجاري مباشرةً وتُرجع الأشخاص المسجلين حاليًا. تجلب الـ API المستندات من السجل عندما تطلبها.
إذا جُلب المستند نفسه قبل وقت قصير، فقد يكون عمره حتى 24 ساعة.
يجب على الشركات نشر القوائم المالية السنوية في موعد أقصاه اثنا عشر شهرًا بعد تاريخ الميزانية، وكثير منها يستنفد المهلة كاملة. لذلك كثيرًا ما تغطي أحدث قائمة السنة قبل الماضية.
لماذا تغيب قيمة ما لدى شركة؟
عادةً لأن الشركة غير ملزمة بنشرها. ما هو علني يتوقف على الشكل القانوني والحجم: فـ GmbH الصغيرة مثلًا لا تنشر قائمة أرباح وخسائر، ولذلك لا توجد لها إيرادات في الغالب. تظهر القيم الفارغة في الاستجابة كـ null أو [].
ماذا يحدث إذا كان لعدة شركات الاسم نفسه؟
عند اسم تشترك فيه عدة شركات، قد تُرجع الـ API إحداها، وليست بالضرورة التي تقصدها، أو تستجيب بـ 404. إذا كنت تحتاج إلى الدقة، فاستعلم بمحكمة السجل ورقم السجل، مثل «Ansbach HRB 6089»، أو بالـ entity_id. رقم السجل وحده لا يكفي، لأن الرقم نفسه موجود لدى محاكم كثيرة.
الفوترة
هل تكلّف الميزة أرصدة إذا لم تُرجع بيانات؟
لا. تُحتسب الميزة فقط عندما تُرجع بيانات. أما وضع الذكاء الاصطناعي فيُحتسب حتى لو لم يجد شركة. ولا يُحتسب فقط إذا ألغت الـ API الطلب بـ 408. ويكلّف الوقت الفعلي أرصدة عن كل جلب مباشر ناجح، حتى لو لم يُظهر شيئًا جديدًا.
كم يكلّف الطلب الفاشل؟
لا شيء. الطلب الذي ينتهي بخطأ لا يُحتسب؛ والاستثناء الوحيد هو رسوم وضع الذكاء الاصطناعي. مع الحالة 402 يذكر meta.request_credit_cost أقصى ما كان سيكلّفه الطلب. المزيد في الأخطاء.
هل أحتاج إلى اشتراك أرصدة؟
لا. يمكنك استخدام ملفات الشركات والبحث والتصدير والمستندات وSignals مع أي حساب؛ تدفع الأرصدة فقط. ويفتح اشتراك الأرصدة بيانات إضافية:
- Plus: ملف الشخص.
- Pro: المؤشرات المالية الرئيسية الموسّعة، وميزة شبكة الشركة، وفلاتر البحث للملكية والإدارة والإعسار، وموضوع Signals «حالات الإعسار».
- Max: كل ما في Pro، إضافةً إلى ميزة المساهمون بالتفصيل، وبيانات النشاط لشركات المرافق الطاقية، وموضوع Signals «التحويلات والاندماج والاستحواذ».
كل ما يتعلق بالأسعار والخطط تجده في الفوترة.
ما مدة صلاحية أرصدة البداية وأرصدة الشحن؟
يحصل الحساب الجديد على 150 رصيد بداية. دون اشتراك أرصدة تكون أرصدة البداية وأرصدة الشحن صالحة لمدة 30 يومًا. وما دام اشتراك الأرصدة نشطًا، فلا تنتهي صلاحيتها.
تقنيًا
ما مهلة الانتظار التي يجب أن أضبطها؟
للوقت الفعلي وملفات الأشخاص والمستندات 120 ثانية على الأقل، لأن هذه الطلبات تستغرق وقتًا أطول. إذا فشل الجلب المباشر وحده مع الوقت الفعلي، تحصل على البيانات المخزنة دون رسوم الوقت الفعلي. وإذا استغرق الطلب وقتًا طويلًا جدًا، ينتهي بـ 408، وللمستندات بـ 504. ولا يُحتسب شيء حينها. حاول مرة أخرى لاحقًا.
كم طلبًا يمكنني إرساله؟
لملفات الشركات 60 طلب في الدقيقة لكل حساب، وللمستندات 5. فوق ذلك تستجيب الـ API بالحالة 429 وتذكر وقت الانتظار في Retry-After. جميع الحدود في الحدود.
هل يمكنني تكرار طلب دون الدفع مرتين؟
نعم، لملفات الشركات وملفات الأشخاص والبحث والمستندات. أرسل قيمة خاصة بك في الـ Header Idempotency-Key. إذا كررت الطلب بالمفتاح نفسه والمعاملات نفسها خلال 24 ساعة، فلا يكلّف شيئًا.
هل يمكنني استخدام عدة مفاتيح API؟
نعم. تحت الحساب › مفاتيح API تنشئ مفاتيح إضافية، مثلًا مفتاحًا لكل تطبيق. إذا حذفت مفتاحًا، يصبح غير صالح فورًا. تتشارك جميع المفاتيح رصيد حسابك.