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:
X-API-Key: bnd_pro_your_token_here
Authorization: Bearer bnd_pro_your_token_here
https://lushai.dev/api/v1/bibles?api_key=bnd_pro_your_token_here
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-Afterresponse 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.