BND DEVELOPER INTEGRATION GUIDE • EVERYTHING YOU CAN BUILD WITH BND API
Developer Playbook & Ideas

Developer Integration Guide

Welcome to the official developer guide for the BnD Platform. Learn how to authenticate API requests across different programming languages and explore high-impact application ideas you can launch using our Mizo Scriptures and Dictionary REST APIs.

1. Authentication & Passing Your API Key

Every request sent to the BnD REST API requires an API key to identify your application and apply your rate limit quota. You can pass your API key using any of the following 4 methods:

Method A (Recommended Header): X-API-Key: bnd_pro_your_token_here
Method B (Standard Bearer Header): Authorization: Bearer bnd_pro_your_token_here
Method C (Query Parameter): https://lushai.dev/api/v1/bibles?api_key=bnd_pro_your_token_here
Method D (Short Query Parameter): https://lushai.dev/api/v1/bibles?key=bnd_pro_your_token_here

2. Code Integration Examples

Select your stack below to see complete, ready-to-run code snippets for querying Mizo Bibles and Dictionaries.

// JavaScript (Fetch API in React, React Native, or Next.js)
const API_URL = "https://bnd.lushai.dev/api/v1/bibles?code=mizo&book=John&chapter=3";
const API_KEY = "YOUR_BND_API_KEY";

async function fetchPassage() {
  try {
    const response = await fetch(API_URL, {
      method: "GET",
      headers: {
        "X-API-Key": API_KEY,
        "Accept": "application/json"
      }
    });

    const data = await response.json();
    console.log("Bible Passage Verses:", data.data);
  } catch (error) {
    console.error("API Integration Error:", error);
  }
}

fetchPassage();

3. Rate Limiting & Quotas

To ensure 99.9% uptime and protect the infrastructure from abuse, every request is rate-limited using a sliding 1-minute window:

Plan Tier Rate Limit (RPM) Cost Target Audience
Starter Free 60 Requests / Minute Free Forever Hobbyists, testing, prototypes
Pro Developer 300 Requests / Minute ₹149 / $1.77 (Lifetime) High-traffic mobile apps & production web apps

Rate limit headers returned on every API call: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

4. What You Can Build Using the BnD API

Our APIs unlock rich Mizo language datasets and multi-translation Scriptures. Here are some high-value application ideas you can build and launch:

📱

Mizo Bible Apps (Flutter / React Native)

Build native iOS and Android mobile Bible applications featuring parallel multi-translation reading (Mizo OV, KJV, NIV, ESV, WEB, NKJV), verse bookmarking, highlighting, and offline sync.

📚

English-Mizo Dictionary & Translator

Create instant bidirectional English to Mizo & Mizo to English dictionary lookup tools with phonetics, parts of speech, definitions, example sentences, and Mizo proverbs (Thufingte).

🤖

Social Media & Messaging Bots

Create automated Telegram, WhatsApp, or Discord bots that post daily Mizo Bible verses, answer scripture queries, or provide instant word definitions directly inside group chats.

🖥️

Church Presentation & Projection Software

Build live projection overlays, EasyWorship/OBS plugins, or web presentation tools for churches to project Mizo Bible passages on screens during Sunday worship services.

💡

Sunday School & Youth Bible Quiz Apps

Develop gamified Bible trivia games, Sunday school quiz apps, or memory verse challenges using our extensive dataset of 188,000+ Bible verses.

🧠

AI & Mizo Natural Language Processing (NLP)

Feed clean, standardized Mizo textual corpora into LLMs, machine translation models, or speech-to-text engines for academic or commercial Mizo language technology development.

5. Security & Integration Best Practices

  • Store Keys Securely: Never hardcode your API key in public client-side JavaScript repositories. Use environment variables (.env) or server proxy wrappers.
  • Handle HTTP 429 Gracefully: If your app exceeds your rate limit, inspect the Retry-After response header and wait before retrying requests.
  • Cache Frequently Requested Passages: Reduce server roundtrips by caching popular chapters or dictionary definitions locally in mobile app SQLite / Room DB.
  • Full CORS Support: All endpoints include Access-Control-Allow-Origin: *, making client-side web integration seamless.