ডেভেলপার ডকুমেন্টেশন

পোর্টালের Connect অংশে একটি integration key তৈরি করুন। কী একবারই দেখানো হয়।

REST API

আপনার প্রতিষ্ঠান যে এজেন্টগুলো ব্যবহার করতে পারে তার তালিকা ও ব্যবহারের হিসাব দেখুন। এই API-তে Hikmu কখনো উত্তর তৈরি করে না: চিন্তা ও উত্তর লেখার কাজ করে আপনার নিজের AI অ্যাপ।

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

OpenAPI 3.1 (openapi.json)

এরর কোড

401 — কী নেই, বাতিল বা ভুল
402 — সক্রিয় সাবস্ক্রিপশন নেই
403 — এই কী দিয়ে এই এজেন্ট বা চ্যানেল ব্যবহার করা যায় না
409 — একই Idempotency-Key কিন্তু ভিন্ন body
422 — অবৈধ request body
429 — রিকোয়েস্ট কোটা শেষ বা rate limit
503 — সার্ভিস সাময়িক বন্ধ; পরে আবার চেষ্টা করুন

MCP

যেকোনো Streamable HTTP MCP client এই URL-এ যুক্ত করুন। OAuth (client সমর্থন করলে) অথবা Authorization header-এ integration key দিয়ে লগইন করুন।

https://hikmu.com/mcp

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

Webhook signature

প্রতিটি delivery আপনার endpoint secret দিয়ে signed। body বিশ্বাস করার আগে signature ও timestamp যাচাই করুন।

// 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>