loading
বিজ্ঞাপন

API Integration

আমাদের API ব্যবহার করতে নিচের উদাহরণ কোডগুলো অনুসরণ করুন। এখানে api-key এবং secret-key ব্যবহার করতে হবে।

PHP cURL Request Example

$curl = curl_init();

curl_setopt_array($curl, array(
CURLOPT_URL => "https://zachaikori.com/api/v1/fraud-check",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => array('mobile' => 'Custom mobile number'),
CURLOPT_HTTPHEADER => array(
    'api-key: {Your api_key}',
    'secret-key: {Your secret_key}',
    'x-customer-domain: request()->getHost()'
),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
                                    
PHP HTTP Request Example

$response = Http::withHeaders([
    'api-key'    => "{Your api_key}",
    'secret-key' => "{Your secret_key}",
    'x-customer-domain' => request()->getHost(),
])->post("https://zachaikori.com/api/v1/fraud-check", [
    'mobile' => $number,
]);

if ($response->successful()) {
    return $response->json();
} else {
    return [
        'status' => 'error',
        'message' => 'API call failed',
        'error' => $response->body(),
    ];
}
                                    

**বিঃদ্রঃ** আমাদের API থেকে প্রাপ্ত `message` ফিল্ডে বিভিন্ন গুরুত্বপূর্ণ তথ্য, যেমন — অফার, আপডেট, নোটিশ বা অ্যাকাউন্ট/প্যাকেজের মেয়াদ শেষ হওয়ার বার্তা প্রদান করা হয়। এই বার্তাগুলো ব্যবহারকারীর জন্য অত্যন্ত গুরুত্বপূর্ণ, কারণ এগুলোর মাধ্যমে ব্যবহারকারী জানতে পারবেন তার API ব্যবহারে কোনো সীমাবদ্ধতা, মেয়াদোত্তীর্ণ বা অন্যান্য নীতিমালা-সংক্রান্ত সমস্যা আছে কি না।
👉 তাই **ডেভেলপারদের অবশ্যই API রেসপন্সে প্রাপ্ত `message` ফিল্ডকে ব্যবহার করতে হবে** এবং সেই অনুযায়ী সিস্টেমে বার্তাগুলো ব্যবহারকারীর কাছে প্রদর্শন করতে হবে। এতে করে ব্যবহারকারী সহজেই বুঝতে পারবেন কোন কারণে API রেসপন্স ব্যর্থ হয়েছে অথবা আমাদের পক্ষ থেকে কোনো নতুন অফার/আপডেট রয়েছে কি না।

Response Example

Response will be in JSON format
✅ Success Response

If the domain is allowed to use the Fraud Check API:


{
    "status": "success",
    "message": "Success", // its show warning or info message
    "data": {
        "pathao": {
            "name": "Pathao",
            "success": 42,
            "cancel": 1,
            "total": 43,
            "rate": 98
        },
        "redx": {
            "name": "RedX",
            "success": "32",
            "cancel": 2,
            "total": "34",
            "rate": 94
        },
        "steadfast": {
            "name": "SteadFast",
            "success": 24,
            "cancel": 1,
            "total": 25,
            "rate": 96
        }
    }
}
                                
❌ Error Response (Invalid API Key)

{
    "status": "error",
    "message": "Unauthorized"
}
                                
❌ Error Response (Blocked User)

{
    "status": "error",
    "message": "আপনার অ্যাকাউন্টটি সাময়িকভাবে বন্ধ করা হয়েছে। অনুগ্রহ করে আপনার অ্যাকাউন্টটি পুনরায় সংযুক্ত করতে আমাদের সাথে যোগাযোগ করুন।"
}
                                
❌ Error Response (Unauthorized Domain)

{
    "status": "error",
    "message": "Unauthorized domain"
}
                                
⚠️ Expired Response

{
    "status": "expired",
    "message": "আপনার ফ্রি ট্রায়ালের আজকের দিনের লিমিট শেষ হয়ে গিয়েছে, পুনরায় চেক করার জন্য রাত ১২ টা পর্যন্ত অপেক্ষা করুন, অথবা আমাদের প্রিমিয়াম প্যাকেজে আপগ্রেড করুন । ধন্যবাদ !"
}
                                
বিজ্ঞাপন