API لإنترنت الأشياء للمطورين — REST وgRPC | Kilo

المطوّرون

واجهة IoT API واحدة لكل ما تبنيه

REST عبر HTTPS وJSON القياسيين، وgRPC حيث تهم العقود المُنمَّطة، وبثّ فوري عبر WebSocket وSSE — كلها موثّقة بمفاتيح API محددة الصلاحيات، ومتطابقة في السحابة وفي التنصيب المحلي.

استكشف مرجع الـ API اقرأ التوثيق

api.kiloiot.io

200 OK 
$ curl -sS https://api.kiloiot.io/api/v2/devices \
    -H "X-API-Key: $KILO_API_KEY" \
    -H "X-Organization-Id: $KILO_ORG_ID"

طلب موثَّق بأبسط صورة — ترويستان، HTTPS قياسي، ورد بصيغة JSON.

البروتوكولات

REST أولًا، وgRPC عند الحاجة، وبثّ للبيانات الحية

بروتوكولان وبثّ فوري على نفس نقطة الوصول المؤمَّنة — اختر الواجهة التي تناسب تكاملك واحتفظ بنفس المفاتيح محددة الصلاحيات.

المسار الأساسي

REST API

HTTPS وJSON قياسيان يعملان من أي عميل HTTP. اقرأ حالة الأجهزة وسجلّ المستشعرات، وأدر لوحات البيانات والاتصالات، وتعامل مع تعريفات القواعد وإصداراتها، وأرسل أوامر إلى الأجهزة — كل ما تسمح به صلاحيات مفتاحك.

  • HTTPS + JSON من أي لغة أو أداة
  • الأجهزة والمستشعرات ولوحات البيانات والقواعد والأوامر
  • موثَّقة نقطةً نقطة على api.kiloiot.io

المسار المتقدم

gRPC API

واجهة مُنمَّطة للتكامل بين الخدمات — عملاء مُولَّدون وعقد ثابت، بنفس مصادقة مفاتيح الـ API المستخدمة في REST. خيار طبيعي للتنصيبات المحلية التي تربط أنظمة داخلية.

  • عملاء مُنمَّطون ومُولَّدون
  • تكامل بين الخدمات وفي التنصيب المحلي
  • نفس مصادقة X-API-Key المستخدمة في REST

بلا استعلام متكرر

البثّ الفوري

القياسات الحية متاحة خارجيًا عبر WebSocket وServer-Sent Events ‏(SSE) — وهي الآليات نفسها التي تعمل بها لوحات بيانات المنصة — لتستهلك أنظمتك البيانات لحظة وصولها بدل الاستعلام عنها مرارًا.

  • نقاط وصول WebSocket وSSE
  • نفس البثّ الذي تعمل عليه لوحات البيانات
  • البيانات لحظة وصولها — بلا دورات تحديث

الأمان

مفاتيح API محددة الصلاحيات، مبنية على مبدأ الحد الأدنى

كل طلب — سواء REST أو gRPC — يُوثَّق بمفتاح محدد الصلاحيات في ترويسة X-API-Key مع مؤسستك في X-Organization-Id. تُنشأ المفاتيح وتُدار في Settings → API Keys.

01

صلاحيات Read وWrite لكل مجال

الأجهزة والمستشعرات ولوحات البيانات والقواعد والأوامر والاتصالات وغيرها — معظم المجالات تفصل القراءة عن الكتابة، ولا يمنح المفتاح إلا ما تختاره عند إنشائه.

02

يُعرض مرة واحدة ويُبدَّل بنقرة

تظهر قيمة المفتاح الكاملة مرة واحدة فقط عند الإنشاء؛ وبعدها لا يبقى ظاهرًا سوى بادئة قصيرة. التدوير يُصدر قيمة جديدة ويعطّل المفتاح القديم فورًا — وهو السبيل الوحيد لاستعادة مفتاح ضائع.

03

انتهاء الصلاحية والحالة وآخر استخدام

حدد تاريخ انتهاء للمفاتيح المؤقتة أو مفاتيح المتعاقدين، وتابع حالة كل مفتاح — Active أو Rotated أو Revoked — مع طابع زمني لآخر استدعاء.

04

عزل على مستوى المؤسسة

ينتمي المفتاح إلى المؤسسة التي أُنشئ فيها، ويجب أن تتطابق مؤسسة كل طلب معها — فلا يمكن لمفتاح عميلٍ أن يمسّ بيانات عميلٍ آخر أبدًا.

Settings → API Keys

⚠ Copy this key now. You will not be able to see it again.

Name Scopes Status Last Used

wms-sync-prod

kilo_9f2…
Devices · ReadSensors · Read
Active 2026-07-01 14:32

analytics-pipeline

kilo_c41…
Dashboards · Read
Active 2026-07-01 09:05

ci-deploy-rules

kilo_77a…
Rules · Write
Rotated 2026-06-12 18:20

contractor-audit

kilo_e08…
Logs · Read
Revoked 2026-05-30 11:47

تُدار في Settings → API Keys: مفتاح لكل تكامل، محدود تمامًا بما يحتاجه.

النشر

نفس واجهة API لإنترنت الأشياء في السحابة وعلى بنيتك التحتية الخاصة

التكاملات المبنية على نقطة الوصول السحابية تنتقل كما هي إلى تنصيب ذاتي الاستضافة — واجهة API واحدة أينما يعمل الخادم.

Kilo Cloud

نقطة الوصول المُدارة: أنشئ مفتاحًا في Settings → API Keys وابدأ استدعاء الـ API — دون بنية تحتية تديرها بنفسك.

  • نقطة وصول مُدارة ومؤمَّنة
  • ابدأ مجانًا — دون بيانات دفع
  • مرجع كامل للـ API على api.kiloiot.io

Kilo On-Premise

الخادم نفسه، مستضاف ذاتيًا داخل حدود شبكتك — بنفس REST وgRPC ونفس المفاتيح محددة الصلاحيات: لا يتغير شيء في تكاملاتك.

  • يعمل داخل حدود شبكتك
  • API متطابقة — تنتقل التكاملات دون تعديل
  • gRPC خيار طبيعي لأتمتة الخدمات الداخلية
تحدث معنا عن التنصيب المحلي →

مفتوح المصدر

KiloCenter — مركز خدمة mioty مفتوح المصدر

KiloCenter هو مركز خدمة mioty مفتوح المصدر من تطويرنا، صادر برخصة AGPL ويُطوَّر علنًا على GitHub. يدير جانب mioty من شبكتك كمنتج قائم بذاته — صُمم للمطورين الذين يريدون امتلاك منظومتهم بالكامل.

تكامل معه عبر gRPC وMQTT، وانشره باستخدام Docker أو Kubernetes، ثم اربطه بما تشغّله بعده.

شاهده على GitHub استكشف mioty Service Center

المطوّرون

أسئلة المطوّرين الشائعة

كيف أُوثّق طلبات الـ API؟

كل طلب يحمل مفتاح API محدد الصلاحيات في ترويسة X-API-Key (بالصيغة kilo_<key>) مع معرّف مؤسستك في X-Organization-Id. تُنشأ المفاتيح في Settings → API Keys، وكل الحركة تمر عبر TLS.

هل أستخدم REST أم gRPC؟

ابدأ بـ REST — فهو المسار الأساسي ويعمل من أي عميل HTTP. اختر gRPC عندما تحتاج تحديدًا إلى عملاء مُنمَّطين مُولَّدين أو تكامل بين الخدمات، وغالبًا في التنصيب المحلي. وكلاهما يُوثَّق بالطريقة نفسها.

هل أحصل على بيانات فورية دون استعلام متكرر؟

نعم. البثّ الحي متاح عبر WebSocket وServer-Sent Events ‏(SSE) — وهي الآليات نفسها التي تستخدمها لوحات بيانات المنصة داخليًا — فتصل البيانات إلى أنظمتك لحظة ورودها.

هل الـ API نفسها في التنصيب المحلي؟

نعم. يعرض التنصيب المحلي نفس الـ API داخل حدود شبكتك، فتنتقل التكاملات المبنية على السحابة دون تعديل — ويكون gRPC هناك الخيار الطبيعي للأتمتة الداخلية.

ابدأ البناء على Kilo IoT API

أنشئ حسابًا مجانيًا، وولّد مفتاحًا محدد الصلاحيات، ونفّذ أول استدعاء خلال دقائق — أو احجز مكالمة لتخطيط نشرٍ محلي.

ابدأ مجانًا احجز مكالمة