تصفّح التوثيق كاملًا

روابط Sheets

كل عنوان يرد على شكل جدول، وكيف يُبنى الجدول، وكم يكلّف الرابط، وما تعرضه الخلية عند حدوث خطأ.

رابط الجدول هو عنوان من Narwhal يرد بجدول تستطيع ورقة البيانات قراءته. هو عنوان GET عادي مع format=csv ومفتاح Sheets في نهايته.

العنوان
https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,IDR&format=csv&key=YOUR_SHEETS_KEY
الجواب
currency,rate,timestamp,stale
EUR,0.90718,2026-11-15T16:00:00Z,false
IDR,18222.7,2026-11-15T16:00:00Z,false

المعلمات

معلمةمطلوبالمعنى
format=csvنعمالرد على شكل جدول.
keyنعممفتاح Sheets من Team and keys في لوحة المعلومات. يُرفض مفتاح API هنا.
حسب المسار نفسهكما يحدده المسارالمعاملات نفسها في طلب JSON، مثل start وend وcurrencies وcountries.

العناوين

استبدل الكلمات بين الأقواس المعقوفة. البلد رمز من ثلاثة أحرف مثل USA.

البياناتالعنوان بعد https://api.narwhalapi.com
العطلات في سنة/v1/calendars/holidays/{country}/{year}
العطلة القادمة/v1/calendars/holidays/{country}/next
تقويم الإصدارات/v1/economics/calendar
مؤشر أسعار المستهلك، الأحدث والتاريخي/v1/economics/{country}/cpi, /cpi/observations
التضخم/v1/economics/{country}/inflation, /inflation/observations
GDP/v1/economics/{country}/gdp, /gdp/observations
نمو الناتج المحلي الإجمالي/v1/economics/{country}/gdp-growth, /gdp-growth/observations
البطالة/v1/economics/{country}/unemployment, /unemployment/observations
معدل المشاركة في القوى العاملة/v1/economics/{country}/labour-force-participation, /observations
التجارة/v1/economics/{country}/trade, /trade/observations
أي سلسلة/v1/economics/series/{series_id}/observations
سعر الفائدة الرئيسي/v1/economics/{country}/central-bank/policy-rate, /policy-rate/history
قرارات أسعار الفائدة/v1/economics/{country}/central-bank/decisions
احتياطيات البنك المركزي/v1/economics/{country}/central-bank/reserves
علاوة مخاطر الأسهم، كل البلدان/v1/economics/equity-risk-premium
علاوة مخاطر الأسهم، بلد واحد/v1/economics/{country}/equity-risk-premium, /history
أسعار السلع، الكل/v1/commodities/spot
سلعة واحدة/v1/commodities/spot/{commodity}/{currency}, /bars
أسعار الصرف/v1/fx/rates/{base}, /observations, /bars
احتمالات قرار سعر الفائدة/v1/predictions/policy-paths/{authority}, /history

كيف يُبنى الجدول

  • صف عناوين واحد، ثم صف لكل عنصر. الطلب الذي يعيد شيئًا واحدًا يعطي صفًا واحدًا.
  • يصبح الحقل المتداخل عمودًا باسم تفصله نقطة، مثل value.actual.
  • قائمة القيم البسيطة تُضم بالفاصلة المنقوطة ;.
  • القيمة الفارغة خلية فارغة. القيمتان المنطقيتان هما true وfalse.
  • تحتفظ الأرقام بالنص نفسه الذي يرسله API.
  • يعطي تقويم الإصدارات صفًا لكل إصدار، مرتبًا بحسب الوقت. يوضح value_count عدد الأرقام في الإصدار؛ ويعرض الصف الرقم الأول.
  • الطلب الذي لا يعيد صفوفًا يعطي ردًا فارغًا.

كم يكلّف الرابط

الرابط هو العنوان مع مفتاحك. أول تحميل له في اليوم يكلّف ما تكلّفه تلك الطلبية عادةً. أي تحميل آخر للرابط نفسه في اليوم نفسه مجاني. يتغير اليوم عند منتصف الليل بتوقيت UTC. تغيير أي جزء من العنوان ينشئ رابطًا جديدًا.

ما تعرضه الخلية عند حدوث خطأ

تعرض الخلية سطرًا واحدًا. يأتي الرد بحالة HTTP رقم 200 حتى تعرضه ورقة البيانات؛ والحالة الحقيقية في الترويسة x-narwhal-status.

السطر في الخليةالحالة الحقيقية
Narwhal: this Sheets key is switched off or not valid. Copy a new link from https://narwhalapi.com/dashboard.401
Narwhal: this is an API key, not a Sheets key. Make a Sheets key at https://narwhalapi.com/dashboard and use it in the link.401
Narwhal: a Sheets key reads data routes only, and the link must end in format=csv.403
Narwhal: out of credit. Add credit at https://narwhalapi.com/dashboard and refresh this sheet.402
Narwhal: too many requests. This sheet will update on its next refresh.429
Narwhal: bad parameter. (what is wrong)400 أو 422

التالي

هل كانت هذه الصفحة مفيدة؟