وثائق المطورين

أنشئ مفتاح تكامل في بوابتك ضمن Connect. يُعرض المفتاح مرة واحدة.

REST API

اعرض الوكلاء الذين يمكن لمؤسستك استخدامهم واقرأ استخدامها. لا تولّد Hikmu إجابات عبر هذه الواجهة أبدًا: تطبيق الذكاء الاصطناعي لديك هو من يفكّر ويجيب.

curl https://hikmu.com/api/v1/agents \
  -H "Authorization: Bearer <YOUR_INTEGRATION_KEY>"

OpenAPI 3.1 (openapi.json)

رموز الأخطاء

401 — مفتاح مفقود أو ملغى أو غير صالح
402 — لا يوجد اشتراك نشط
403 — لا يمكن للمفتاح استخدام هذا الوكيل أو القناة
409 — نفس Idempotency-Key مع محتوى مختلف
422 — محتوى طلب غير صالح
429 — نفدت حصة الطلبات أو تجاوز حد المعدل
503 — الخدمة متوقفة مؤقتاً؛ أعد المحاولة لاحقاً

MCP

وجّه أي عميل MCP يدعم Streamable HTTP إلى هذا العنوان. صادق عبر OAuth (إن دعمه العميل) أو بمفتاح تكامل في ترويسة Authorization.

https://hikmu.com/mcp

tools: find_experts, consult_expert, get_playbook, lookup_knowledge, run_expert_tool, send_feedback, get_my_usage, connection_health

توقيعات Webhook

كل تسليم موقّع بسر نقطة النهاية لديك. تحقق من التوقيع والطابع الزمني قبل الوثوق بالمحتوى.

// header: ukh-signature: t=<unix seconds>,v1=<hex>
const expected = hmacSHA256(secret, `${t}.${rawBody}`);
// reject if |now - t| > 300 s or expected !== v1 (constant-time compare)

Hosted Add-on (أداة الموقع)

<script src="https://hikmu.com/embed.js" data-widget="wid_…" async></script>