روابط Sheets
كل عنوان يرد على شكل جدول، وكيف يُبنى الجدول، وكم يكلّف الرابط، وما تعرضه الخلية عند حدوث خطأ.
رابط الجدول هو عنوان من Narwhal يرد بجدول تستطيع ورقة البيانات قراءته. هو عنوان GET عادي مع format=csv ومفتاح Sheets في نهايته.
https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,IDR&format=csv&key=YOUR_SHEETS_KEYcurrency,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:/ |
|---|---|
| العطلات في سنة | / |
| العطلة القادمة | / |
| تقويم الإصدارات | / |
| مؤشر أسعار المستهلك، الأحدث والتاريخي | /, / |
| التضخم | /, / |
| GDP | /, / |
| نمو الناتج المحلي الإجمالي | /, / |
| البطالة | /, / |
| معدل المشاركة في القوى العاملة | /, / |
| التجارة | /, / |
| أي سلسلة | / |
| سعر الفائدة الرئيسي | /, / |
| قرارات أسعار الفائدة | / |
| احتياطيات البنك المركزي | / |
| علاوة مخاطر الأسهم، كل البلدان | / |
| علاوة مخاطر الأسهم، بلد واحد | /, / |
| أسعار السلع، الكل | / |
| سلعة واحدة | /, / |
| أسعار الصرف | /, /, / |
| احتمالات قرار سعر الفائدة | /, / |
كيف يُبنى الجدول
- صف عناوين واحد، ثم صف لكل عنصر. الطلب الذي يعيد شيئًا واحدًا يعطي صفًا واحدًا.
- يصبح الحقل المتداخل عمودًا باسم تفصله نقطة، مثل
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 |
التالي
هل كانت هذه الصفحة مفيدة؟