🔌 API Documentation

Ikhtisar

API Bahtsul Masail memungkinkan AI agents, aplikasi, dan developer mengakses mesin pencari kitab Islam klasik secara programatik. Gunakan API ini untuk:

• Mencari referensi fikih dari ribuan kitab
• Mendapatkan sintesis AI dari hasil pencarian
• Membaca halaman kitab secara langsung
• Mengintegrasikan dengan tools AI (MCP, LangChain, dsb.)

Autentikasi

Semua request API menggunakan API key via header X-API-Key:

curl -X POST https://bahtsulmasail.tech/api/v1/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bm_your_api_key_here" \
  -d '{"query": "hukum shalat jamak qasar"}'

Endpoints

{
  "query": "hukum nikah siri menurut mazhab syafii",
  "max_results": 10,
  "include_ai": true
}

{
  "query": "hukum nikah siri",
  "result_count": 5,
  "detected_language": "Indonesian",
  "detected_domain": "Munakahat",
  "translated_terms": [
    "نكاح سري",
    "نكاح بغير ولي"
  ],
  "ai_answer": "Berdasarkan kitab-kitab...",
  "results": [
    {
      "book_id": 1234,
      "title": "باب النكاح",
      "content_snippet": "...",
      "page": "45",
      "score": 85.2,
      "book_name": "المجموع شرح المهذب",
      "author_name": "الإمام النووي",
      "source_type": "kitab"
    }
  ]
}

MCP Integration (AI Agents)

Bahtsul Masail dapat digunakan sebagai MCP (Model Context Protocol) server untuk AI agents:

{
  "mcpServers": {
    "bahtsulmasail": {
      "url": "https://bahtsulmasail.tech/api/v1/search",
      "headers": {
        "X-API-Key": "bm_your_api_key_here"
      },
      "description": "Search 7,800+ classical Islamic texts (kitab kuning)"
    }
  }
}

Atau gunakan langsung via HTTP request di tool definition AI agent Anda.

Rate Limits

Rate limit headers disertakan di setiap response. Jika melebihi batas, Anda akan menerima HTTP 429.

Error Codes

Kelola API Keys