{
    "api": "BDRIS জন্ম নিবন্ধন যাচাই API",
    "version": "2.0",
    "base_url": "https:\/\/sohagmia-001-site1.qtempurl.com",
    "flow": {
        "step_1": "GET https:\/\/sohagmia-001-site1.qtempurl.com\/api\/captcha  →  api_token + captcha_image পান",
        "step_2": "captcha_image (base64 GIF) দেখে উত্তর বের করুন (যেমন: 43+35=? → 78)",
        "step_3": "POST https:\/\/sohagmia-001-site1.qtempurl.com\/api\/verify  →  { api_token, ubrn, birth_date, captcha_answer }",
        "step_4": "JSON response-এ সব তথ্য পাবেন (office_location, photo_base64 সহ)"
    },
    "endpoints": [
        {
            "method": "GET",
            "path": "\/api\/captcha",
            "description": "BDRIS থেকে নতুন ক্যাপচা সেশন তৈরি করে। api_token 5 মিনিট কার্যকর থাকে।",
            "response_example": {
                "success": true,
                "api_token": "ff00dedcc0e6d65db8dfe4a646b9ec62",
                "captcha_image": "data:image\/gif;base64,...",
                "expires_in": 300,
                "note": "captcha_image দেখে উত্তর নিন। POST \/api\/verify তে api_token সহ পাঠান।"
            }
        },
        {
            "method": "POST",
            "path": "\/api\/verify",
            "description": "জন্ম নিবন্ধন যাচাই করে। আগে GET \/api\/captcha করে api_token নিতে হবে।",
            "content_type": "application\/json",
            "request_body": {
                "api_token": "string — GET \/api\/captcha থেকে পাওয়া token (required)",
                "ubrn": "string — ১৭ সংখ্যার জন্ম নিবন্ধন নম্বর (required)",
                "birth_date": "string — জন্ম তারিখ yyyy-MM-dd ফরম্যাটে, যেমন: 2006-12-01 (required)",
                "captcha_answer": "string — ক্যাপচার উত্তর, যেমন: 78 (required)"
            },
            "success_response": {
                "success": true,
                "data": {
                    "registration_date": "04 July 2025",
                    "registration_office": "2 No. Nazirpur Union Parishad",
                    "issuance_date": "04 July 2025",
                    "date_of_birth": "01 December 2006",
                    "birth_registration_number": "20067214071156682",
                    "sex": "FEMALE",
                    "office_location": "NAZIRPUR, KALMAKANDA, NETROKONA",
                    "registered_person_name": {
                        "bn": "রেশমা আক্তার",
                        "en": "RESHMA AKTER"
                    },
                    "place_of_birth": {
                        "bn": "পটুয়াখালী",
                        "en": "PATUAKHALI"
                    },
                    "mothers_name": {
                        "bn": "আকলিমা বেগম",
                        "en": "Aklima Begum"
                    },
                    "mothers_nationality": {
                        "bn": "বাংলাদেশী",
                        "en": "Bangladeshi"
                    },
                    "fathers_name": {
                        "bn": "মিলন জোমাদ্দার",
                        "en": "Milon Jommaddar"
                    },
                    "fathers_nationality": {
                        "bn": "বাংলাদেশী",
                        "en": "Bangladeshi"
                    },
                    "photo_base64": "data:image\/png;base64,..."
                }
            },
            "error_responses": [
                {
                    "http_status": 400,
                    "error": "api_token, ubrn, birth_date এবং captcha_answer — সব প্রয়োজন।"
                },
                {
                    "http_status": 401,
                    "error": "api_token অবৈধ বা মেয়াদ শেষ। \/api\/captcha থেকে নতুন token নিন।"
                },
                {
                    "http_status": 422,
                    "error": "ক্যাপচা ভুল হয়েছে। আবার চেষ্টা করুন।"
                },
                {
                    "http_status": 422,
                    "error": "কোনো তথ্য পাওয়া যায়নি। নম্বর ও তারিখ সঠিক কিনা দেখুন।"
                },
                {
                    "http_status": 503,
                    "error": "BDRIS সার্ভারে সংযোগ ব্যর্থ।"
                }
            ]
        },
        {
            "method": "GET",
            "path": "\/api\/docs",
            "description": "এই API ডকুমেন্টেশন।"
        }
    ],
    "notes": {
        "captcha_note": "api_token মাত্র একবার ব্যবহার করা যাবে। ক্যাপচা ভুল হলে নতুন api_token নিন।",
        "date_format": "birth_date সবসময় yyyy-MM-dd ফরম্যাটে দিন। যেমন: 01\/12\/2006 → 2006-12-01",
        "photo": "photo_base64 ফিল্ডে নিবন্ধিত ব্যক্তির ছবি base64 এনকোড করা আসে।",
        "office": "office_location ফিল্ডে নিবন্ধন অফিসের পূর্ণ ঠিকানা আসে (যেমন: NAZIRPUR, KALMAKANDA, NETROKONA)"
    }
}