API وWebhooks والجداول
اربط قياسي بالأنظمة التي تستخدمها. مفاتيح API وWebhooks متاحة في الباقات التي تتضمن واجهة API، ويديرها المالكون والمسؤولون من الإعدادات، واجهة المطورين.
مزامنة الجداول
اسحب قيم المؤشر من جدول كل ساعة بدلاً من كتابتها.
- افتح المؤشر، وانتقل إلى تبويب البيانات، واختر ربط جدول.
- الصق رابط الجدول:
- Google Sheets عام: ملف، مشاركة، النشر على الويب، ثم الورقة بصيغة قيم مفصولة بفواصل.
- Google Sheets خاص: شارك الجدول بصلاحية عارض مع البريد الذي يعرضه قياسي، ثم الصق رابطه العادي.
- Excel Online (OneDrive أو SharePoint): مشاركة، أي شخص لديه الرابط يمكنه العرض، نسخ الرابط.
- اختر عمود التاريخ وعمود القيمة، ولمن تُنسب القيم.
- احفظ. استخدم مزامنة الآن للتشغيل فوراً. يوقف فصل المزامنة، وتبقى القيم المحفوظة.
مفاتيح API
- في واجهة المطورين أنشئ مفتاحاً واختر صلاحيته: قراءة، أو كتابة القيم أيضاً.
- انسخ المفتاح فوراً، فهو لا يظهر مرة أخرى.
يعمل المفتاح بصلاحيات من أنشأه. أرسله في ترويسة Authorization:
Authorization: Bearer qk_your_key
العنوان الأساسي: https://bk.qyasy.com/api/v1/t/<company-domain>/external، حيث <company-domain> نطاق شركتك.
GET /kpisيعرض المؤشرات.GET /kpis/{id}/valuesيقرأ قيم مؤشر.POST /kpis/{id}/valuesيرسل القيم (يحتاج صلاحية كتابة القيم).GET /objectivesيعرض الأهداف.
مثال: إرسال قيمتين.
POST /kpis/12/values
Content-Type: application/json
{ "values": [
{ "date": "2026-10-01", "actual": 1520 },
{ "date": "2026-11-01", "actual": 1610 }
] }
يمكنك إرسال حتى 500 قيمة في الطلب الواحد، ويوضح الرد ما حُفظ وسبب رفض أي قيمة. حد المفتاح 120 طلباً في الدقيقة.
Webhooks
يرسل قياسي طلب POST موقّعاً إلى عنوان HTTPS لديك عند هذه الأحداث:
entry.saved: حُفظت قيمة.kpi.off_track: تحوّل مؤشر إلى الأحمر.period.approved: اعتُمدت فترة.action.assigned: أُسند إجراء.
يحمل كل طلب ترويسة X-Qyasy-Event باسم الحدث، وترويسة X-Qyasy-Signature بقيمة sha256= متبوعة بـ HMAC-SHA256 لنص الطلب الخام باستخدام السر الخاص بالـ Webhook. تحقق من التوقيع قبل الوثوق بالطلب، مثلاً في Node.js:
const crypto = require("crypto");
const expected = "sha256=" + crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
const ok = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signatureHeader));
يجب أن يكون عنوان الـ Webhook عنوان HTTPS عاماً.
جاهز لتجعل الأداء واضحاً للجميع؟
ابدأ تجربتك المجانية