Bitculator · التضمينات · v1

أدوات التضمين

ضَع أدوات Bitculator المباشرة للعملات الرقمية على موقعك عبر <iframe> واحد - رسم بياني للسعر في الوقت الفعلي، ومحوّل، وأداة تبديل القيمة السوقية، وست حاسبات. بلا SDK وبلا خطوة بناء.

9 أداة مفتاح التضمين + النطاق الوضع المجهول

كل أداة هي صفحة مستقلة ضمن /{locale}/embed/… تضعها في موقعك عبر <iframe>. وهي تعرض بيانات السوق المباشرة من Bitculator - تدفق البيانات نفسه الذي يستخدمه التطبيق - ولا تحتاج إلى أي JavaScript من جانبك.

الصقه في أي مكان - دون الحاجة إلى وسم script:

<iframe src="https://bitculator.com/ar/embed/converter/bitcoin/usd?embed_key=YOUR_EMBED_KEY"
        title="Bitculator converter" loading="lazy"
        width="100%" height="470" style="border:0;border-radius:12px"></iframe>

أضِف مفتاح التضمين كمعامل استعلام وسجّل النطاق الذي ستُضمّن عليه (كلاهما من وحدة تحكم المطوّرين). وتعمل التضمينات بلا مفتاح أيضًا في الوضع المجهول - وهو مفيد لتجربة سريعة - لكنها محدودة لكل عنوان IP للزائر. وتحترم كل أداة قيمة {locale} في الـ URL وتتبع ملف تعريف الارتباط theme (أو ?theme=dark).

Content-Security-Policy

هل تُطبّق Content-Security-Policy على موقعك؟ أضِف https://bitculator.com إلى frame-src (وإلى child-src للمتصفحات الأقدم) كي تتمكن الأداة من التحميل. ولا حاجة إلى تغيير أي شيء من جانبنا - فـ Bitculator يسمح أصلًا بالتضمين على أي نطاق.

Content-Security-Policy: frame-src https://bitculator.com

مُنشئ المقتطف

اختر أداة وخياراتها - ويُحدَّث مقتطف التضمين أثناء ذلك. انسخه أو افتح معاينة مباشرة في تبويب جديد.

الأداة

compact

المظهر مفتاح التضمين

مقتطف التضمين افتح المثال

تُعرض مباشرةً في الوضع المجهول.

المصادقة

مفتاح التضمين رمز يحمل صلاحية api، يُنشأ من وحدة تحكم المطوّرين. وخلافًا لمفاتيح Data API، يُمرَّر في عنوان URL الخاص بالـ iframe كمعامل استعلام - لا في ترويسة أبدًا - لذا فهو عام بطبيعته. وهو يحمل صلاحية api وحدها؛ أما مفاتيح data-api المقتصرة على Bearer فتُرفض هنا كي لا تتسرّب إلى المُحيلات أو السجلات.

مرّره على هيئة ?embed_key=… (أو الاسم البديل ?api_key=…). ويجب كذلك أن يأتي الطلب المُزوَّد بمفتاح من نطاق مُدرج في قائمة السماح (انظر أدناه). وإذا كنت مسجّل الدخول إلى Bitculator في المتصفح نفسه، فيُتخطّى فحص المفتاح لجلستك أنت.

النطاقات

لا يُعرض التضمين المُزوَّد بمفتاح إلا على النطاقات التي سجّلتها. يقرأ Bitculator ترويسة Referer للصفحة المُضمِّنة (وإلا فترويسة Origin)، ويُوحّد صيغتها (أحرف صغيرة، وإزالة www. وأي نقطة في النهاية)، ثم يطابقها تمامًا مع قائمة السماح لديك. ويُعيد أي مضيف غير مسجّل أو يتعذّر قراءته الرمز 403.

أدِر النطاقات من وحدة تحكم المطوّرين؛ وتسمح كل خطة بعدد محدّد منها (أدناه). وبما أن Referer/Origin يضبطها متصفح الزائر ويمكن انتحالها، فإن قائمة السماح حماية من إعادة استخدام المفتاح العابرة، لا دليل تشفيري - وعامِل المفتاح على أنه عام في الحالتين. أما التضمينات المجهولة (بلا مفتاح) فليست مقيّدة بالنطاق؛ بل محدودة لكل عنوان IP.

الحصة والحدود

تسحب التضمينات من رصيد شهري منفصل تمامًا عن Data API - بخطته الخاصة وعدّاده الخاص. وتُحتسب التحميلات المجهولة لكل عنوان IP للزائر (1,000 شهريًا)، بينما تُحتسب التحميلات المُزوَّدة بمفتاح ضمن الحد الشهري لخطتك. وتُصفَّر الخطط المجانية مع الشهر الميلادي، أما الخطط المدفوعة فتُصفَّر في يوم الفوترة.

*لا تحمل استجابات التضمين أي ترويسات `X-Quota-** - عن قصد، كي لا تتسرّب أرقام الحصة إلى صفحات زوّارك. تابع استخدامك من [وحدة تحكم المطوّرين](/user/developer/api) بدلًا من ذلك. (ترويساتX-Quota-*` التي ربما رأيتها موجودة على Data API وحدها.)

تجاوز الحد

عندما تتجاوز الأداة حصتها تُعيد الرمز 429. وداخل iframe المتصفح تظهر صفحة صغيرة منسّقة تحمل رسالة "تم بلوغ حد الاستخدام" (كي لا ينكسر تخطيط صفحتك)؛ أما مُستدعي JSON فيحصل على {"message", "limit", "used"}. أضِف مفتاحًا أو ارفع مستوى خطتك للمزيد.

الخطط

خطط التضمين منفصلة عن خطة Data API لديك. ويبدأ كل حساب على الخطة المجانية؛ ويحصل الزوار بلا مفتاح على المستوى المجهول.

الخطة	مرات التحميل / الشهر	النطاقات	المفاتيح
مجانية	10,000	1	2
مبتدئة	50,000	3	5
احترافية	500,000	10	10
مجهولة	1,000 لكل IP	-	-

الخطة المجهولة هي المستوى بلا مفاتيح - بلا نطاقات ولا مفاتيح، وبحدّ لكل عنوان IP للزائر. قم بالترقية من وحدة تحكم المطوّرين.

أدوات التضمين

تسع أدوات جاهزة للتضمين. انسخ المقتطف، وضع مفتاحك، وسجّل نطاقك - وانتهى الأمر. تُحَلّ مقاطع المسار (مثل slug العملة) حسب slug الأصل، ويجب أن يكون سوقًا نشطًا؛ كما تقبل كل أداة معاملات الاستعلام المشتركة الواردة أدناه.

GET

محوّل العملات

/{locale}/embed/converter/bitcoin/usd

حوّل مبلغًا بين أي أصلين من العملات الرقمية أو النقدية بأسعار السوق اللحظية، مع جدول مقارنة اختياري.

مقتطف التضمين افتح المثال

<iframe src="https://bitculator.com/ar/embed/converter/bitcoin/usd?embed_key=YOUR_EMBED_KEY"
        title="Bitculator converter" loading="lazy"
        width="100%" height="470" style="border:0;border-radius:12px"></iframe>

المعامل	الموضع	الافتراضي
fromالأصل المراد التحويل منه، بالـ slug (سوق نشط).	المسار	-
toالأصل المراد التحويل إليه، بالـ slug (سوق نشط).	المسار	-
hideTableيخفي جدول المقارنة ويعرض المحوّل وحده.	الاستعلام	false
compactيعرض تخطيطًا مضغوطًا بمسافات أضيق - مناسب للأعمدة الضيقة.	الاستعلام	false

معاينة مباشرة

GET

مخطط سجل الأسعار

/{locale}/embed/zoom/bitcoin

سجل سعر العملة كاملًا في مخطط تفاعلي، مع أداة لاختيار أكبر الأسواق حسب القيمة السوقية.

مقتطف التضمين افتح المثال

<iframe src="https://bitculator.com/ar/embed/zoom/bitcoin?embed_key=YOUR_EMBED_KEY"
        title="Bitculator price chart" loading="lazy"
        width="100%" height="460" style="border:0;border-radius:12px"></iframe>

المعامل	الموضع	الافتراضي
slugالعملة أو التوكن المراد رسمه بيانيًا، بالـ slug (سوق نشط).	المسار	-
compactيعرض تخطيطًا مضغوطًا بمسافات أضيق - مناسب للأعمدة الضيقة.	الاستعلام	false

معاينة مباشرة

GET

حاسبة الانقلاب السوقي

/{locale}/embed/flip/bitcoin/ethereum

"الانقلاب" - كم سيبلغ سعر أصل ما عند القيمة السوقية لأصل آخر، مع المضاعف الضمني.

مقتطف التضمين افتح المثال

<iframe src="https://bitculator.com/ar/embed/flip/bitcoin/ethereum?embed_key=YOUR_EMBED_KEY"
        title="Bitculator marketcap flipper" loading="lazy"
        width="100%" height="460" style="border:0;border-radius:12px"></iframe>

المعامل	الموضع	الافتراضي
entity1الأصل الذي يُعاد إسقاط سعره، بالـ slug (سوق نشط).	المسار	-
entity2الأصل الذي تُطبَّق قيمته السوقية، بالـ slug (سوق نشط).	المسار	-
compactيعرض تخطيطًا مضغوطًا بمسافات أضيق - مناسب للأعمدة الضيقة.	الاستعلام	false

معاينة مباشرة

GET

محاكي DCA

/{locale}/embed/dca

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

مقتطف التضمين افتح المثال

<iframe src="https://bitculator.com/ar/embed/dca?embed_key=YOUR_EMBED_KEY"
        title="Bitculator DCA simulator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

المعامل	الموضع	الافتراضي
compactيعرض تخطيطًا مضغوطًا بمسافات أضيق - مناسب للأعمدة الضيقة.	الاستعلام	false

معاينة مباشرة

GET

حاسبة الأرباح

/{locale}/embed/profit

صافي الربح والخسارة والعائد على الاستثمار انطلاقًا من سعر الشراء وسعر البيع والكمية والرسوم.

مقتطف التضمين افتح المثال

<iframe src="https://bitculator.com/ar/embed/profit?embed_key=YOUR_EMBED_KEY"
        title="Bitculator profit calculator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

المعامل	الموضع	الافتراضي
compactيعرض تخطيطًا مضغوطًا بمسافات أضيق - مناسب للأعمدة الضيقة.	الاستعلام	false

معاينة مباشرة

GET

حاسبة الفائدة

/{locale}/embed/interest

توقَّع القيمة المستقبلية لحيازتك انطلاقًا من رأس المال الأولي ونسبة الفائدة وتواتر التركيب.

مقتطف التضمين افتح المثال

<iframe src="https://bitculator.com/ar/embed/interest?embed_key=YOUR_EMBED_KEY"
        title="Bitculator interest calculator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

المعامل	الموضع	الافتراضي
compactيعرض تخطيطًا مضغوطًا بمسافات أضيق - مناسب للأعمدة الضيقة.	الاستعلام	false

معاينة مباشرة

GET

حاسبة الضرائب

/{locale}/embed/tax

قدّر المبلغ الخاضع للضريبة والضريبة المستحقة على أرباح التداول والتعدين والستاكينغ والإسقاطات الجوية والعوائد.

مقتطف التضمين افتح المثال

<iframe src="https://bitculator.com/ar/embed/tax?embed_key=YOUR_EMBED_KEY"
        title="Bitculator tax calculator" loading="lazy"
        width="100%" height="580" style="border:0;border-radius:12px"></iframe>

المعامل	الموضع	الافتراضي
compactيعرض تخطيطًا مضغوطًا بمسافات أضيق - مناسب للأعمدة الضيقة.	الاستعلام	false

معاينة مباشرة

GET

حاسبة القروض

/{locale}/embed/loan

حاكِ قرضًا بالعملات الرقمية - السداد وإجمالي الفوائد وجدول الإطفاء التفصيلي.

مقتطف التضمين افتح المثال

<iframe src="https://bitculator.com/ar/embed/loan?embed_key=YOUR_EMBED_KEY"
        title="Bitculator loan calculator" loading="lazy"
        width="100%" height="580" style="border:0;border-radius:12px"></iframe>

المعامل	الموضع	الافتراضي
compactيعرض تخطيطًا مضغوطًا بمسافات أضيق - مناسب للأعمدة الضيقة.	الاستعلام	false

معاينة مباشرة

GET

حاسبة الستاكينغ

/{locale}/embed/staking

قدّر مكافآت الستاكينغ انطلاقًا من المبلغ المُستخدَم في الستاكينغ ومعدّل APR/APY والمدة.

مقتطف التضمين افتح المثال

<iframe src="https://bitculator.com/ar/embed/staking?embed_key=YOUR_EMBED_KEY"
        title="Bitculator staking calculator" loading="lazy"
        width="100%" height="520" style="border:0;border-radius:12px"></iframe>

المعامل	الموضع	الافتراضي
compactيعرض تخطيطًا مضغوطًا بمسافات أضيق - مناسب للأعمدة الضيقة.	الاستعلام	false

معاينة مباشرة