كم مرة يتحدث السعر؟

يمكن أن تتحدث نقطة نهاية السعر الفوري كل 60 ثانية. يعمل سير العمل القابل للتنزيل كل ساعة، وينفّذ طلب API واحدا في كل تشغيل. تحقق من أثر الجدولة على الحصة الشهرية قبل تغييرها.

هل تكفي الخطة المجانية مع التحديث التلقائي؟

نعم، عند التشغيل كل ساعة: 24 × 30 تعادل نحو 720 طلبا شهريا، ضمن حد الخطة المجانية البالغ 5,000 طلب. التشغيل كل 15 دقيقة يستهلك نحو 2,880 شهريا، وكل 5 دقائق نحو 8,640 شهريا. تُجمع طلبات مسارات العمل المتعددة.

هل يمكنني استخدامه تجاريا؟

الاستخدام التجاري مسموح في جميع الخطط. لا تتطلب الخطط المدفوعة رابط نسبة إلى goldprice.dev، أما الخطة المجانية فتتطلب وضع رابط ظاهر إلى goldprice.dev بجوار الأسعار المعروضة.

لماذا تثبيت إصدار HTTP Request v4؟

يحدد الملف HTTP Request بالإصدار typeVersion: 4.2 وSchedule Trigger بالإصدار typeVersion: 1.2 ، بما يوافق بنية تصدير سير العمل في n8n 2.x المستخدمة هنا. راجع أي إشعار ترحيل يعرضه n8n بعد الاستيراد وقبل النشر.

ما المعادن المدعومة؟

المعادن المدعومة هي الذهب (XAU)، والفضة (XAG)، والنحاس (HG). لا يتوفر البلاتين أو البلاديوم في أي خطة. غيّر رمز المعدن في الرمز الكامل، مثلا XAG-USD-SPOT لجلب سعر الفضة.

هل الخطة المجانية مجانية فعلا؟

نعم، تشمل الخطة المجانية 5,000 طلب شهريا دون بطاقة ائتمان، ولا تنتهي صلاحيتها. احصل على مفتاح API الخاص بك من صفحة /onboarding لبدء استخدام الخطة المجانية.

هل يمكن أن يكتب Claude هذا لي؟

نعم. أتح لخادم Claude الوصول إلى خادم MCP من goldprice.dev واطلب: أنشئ سير عمل n8n 2.x يستدعي /v1/spot/XAU-USD-SPOT كل ساعة باستخدام HTTP Request v4.2. استخدم Header Auth للترويسة X-API-Key، ولا تُضمّن بيانات الاعتماد في التصدير. افحص العقد المستوردة واختبر يدويا قبل النشر.

أسعار الذهب المباشرة في n8n

لأتمتة أسعار الذهب المباشرة في n8n، استورد JSON لسير عمل goldprice.dev دون بيانات اعتماد، وأنشئ بيانات اعتماد Header Auth باسم X-API-Key واربطها بعقدة HTTP Request v4.2. يستدعي سير العمل غير النشط api.goldprice.dev/v1/spot/XAU-USD-SPOT كل ساعة عبر Schedule Trigger v1.2. يستهلك نحو 720 طلبا في شهر من 30 يوما، ضمن حد الخطة المجانية البالغ 5,000 شهريا. انشره بعد نجاح تشغيل يدوي.

احصل على مفتاح API من goldprice.dev

أنشئ حسابا مجانيا على goldprice.dev/onboarding. تعرض لوحة التحكم مفتاحا يبدأ بـ ga_live_. ستحفظه في بيانات اعتماد n8n في الخطوة التالية. لا تلصقه مباشرة داخل عقدة.

تشمل الخطة المجانية 5,000 طلب شهريا وأسعار الذهب الفورية بـ 31 عملة. لا تحتاج إلى بطاقة ائتمان.

استورد سير العمل دون بيانات اعتماد

**نزّل JSON لسير عمل n8n الذي يعمل كل ساعة**، ثم اختر استيراد من ملف في n8n. يتضمن عقدتي Schedule Trigger v1.2 وHTTP Request v4.2، ويكون غير نشط افتراضيا، ولا يحتوي على مفتاح API أو ارتباط ببيانات اعتماد.

أنشئ بيانات اعتماد Header Auth واربطها

أنشئ بيانات اعتماد Header Auth في n8n. اضبط الاسم على X-API-Key والقيمة على مفتاح goldprice.dev. افتح جلب سعر الذهب، واختر نوع بيانات اعتماد عام → Header Auth، وحدد بيانات الاعتماد. حفظ السر في بيانات اعتماد n8n يمنع ظهوره في JSON عند تصدير سير العمل.

n8n · مقتطف من عقدة طلب HTTP

{  "parameters": {    "url": "https://api.goldprice.dev/v1/spot/XAU-USD-SPOT",    "authentication": "genericCredentialType",    "genericAuthType": "httpHeaderAuth",    "options": {      "response": {        "response": {          "neverError": false,          "responseFormat": "autodetect"        }      },      "timeout": 5000    }  },  "type": "n8n-nodes-base.httpRequest",  "typeVersion": 4.2,  "retryOnFail": true,  "maxTries": 3,  "waitBetweenTries": 2000,  "onError": "continueErrorOutput"}

شغّله مرة وافحص الناتج

انقر على تنفيذ سير العمل. تأكد من أن جلب سعر الذهب يعيد السعر وcomputed_at وis_stale. أسعار الشراء والبيع للخطط المدفوعة فقط وقد تغيب. أصلح أخطاء بيانات الاعتماد قبل النشر. بعد نجاح التشغيل اليدوي، انشر سير العمل لتفعيل الجدولة كل ساعة.

غيّر العملة أو المعدن

عدّل الجزء الأخير من URL في جلب سعر الذهب. صيغة الرموز هي METAL-CURRENCY-SPOT. لاستخدام رموز متعددة، أنشئ عناصر إدخال واستخدم https://api.goldprice.dev/v1/spot/{{ $json.symbol }} في عقدة HTTP Request.

n8n · عناصر إدخال بعملات متعددة

[  { "symbol": "XAU-USD-SPOT" },  { "symbol": "XAU-INR-SPOT" },  { "symbol": "XAU-EUR-SPOT" },  { "symbol": "XAG-USD-SPOT" }]

النتيجة المتوقعة

JSON

{  "symbol": "XAU",  "quote_currency": "USD",  "unit": "troy_ounce",  "contract_type": "spot",  "price": "4012.75",  "is_stale": false,  "computed_at": "2026-08-18T08:00:00Z"}

تعرض لوحة مخرجات عقدة HTTP Request بيانات JSON كاملة. تشير العقد اللاحقة إلى أي حقل باستخدام تعبيرات مثل {{ $json.price }} أو {{ $json.computed_at }}.

أخطاء شائعة

الرمز	ما يظهر لك	الحل
401	تفشل عقدة HTTP Request بالخطأ `401 Unauthorized`	مفتاح API مفقود أو غير صالح. افتح بيانات الاعتماد → X-API-Key، والصق مفتاحا جديدا من لوحة التحكم. تحقق من تحديد بيانات الاعتماد في قائمة المصادقة بعقدة HTTP Request عبر نوع بيانات اعتماد عام → Header Auth.
429	ظهور `429 Too Many Requests` أحيانا في فرع مخرجات الأخطاء	الجدولة متكررة جدا، أو تتشارك عدة مسارات عمل الخطة نفسها. التشغيل كل ساعة يستهلك نحو 720 طلبا خلال 30 يوما، وكل 15 دقيقة يستهلك 2,880. قلّل تكرار التشغيل، وانتظر إرشادات API لإعادة ضبط الحد قبل المحاولة مجددا. تظهر حالات الفشل المستمرة في مخرجات أخطاء العقدة.
N/A	يحتوي JSON لسير العمل على مفتاح API كنص مكشوف بعد التصدير	لصقت المفتاح في URL أو حقل ترويسة دون استخدام بيانات اعتماد. احذفه، وأنشئ بيانات اعتماد Header Auth كما في الخطوة 3، وحددها في قائمة المصادقة. لا يصدّر n8n قيم بيانات الاعتماد، لكنه يصدّر القيم المكتوبة مباشرة كما هي.
N/A	ينجح التشغيل اليدوي، لكن سير العمل لا يعمل كل ساعة	سير العمل المستورد غير نشط عمدا. انشره بعد نجاح اختبار بيانات الاعتماد يدويا. لا يعمل Schedule Trigger إلا لسير عمل منشور.

خطوات إضافية

أضف عقدة Postgres بعد HTTP Request لإدراج صفوف {symbol, price, computed_at} لتحليل السلاسل الزمنية
استخدم عقدة IF للتفرع حسب price > threshold وإرسال تنبيه عبر Slack/Discord عند تحقق الشرط
كرّر التنفيذ على عناصر إدخال متعددة لتتبع الذهب والفضة والنحاس في سير عمل واحد
اربط مخرجات الأخطاء بقناة Slack لتظهر أخطاء 429 كتنبيهات واضحة

كيفية جلب أسعار الذهب المباشرة في n8n