Java Technologies JSON এর মাধ্যমে API Response এবং Request Management গাইড ও নোট

JSON (JavaScript Object Notation) হল একটি জনপ্রিয় ডেটা ফরম্যাট যা API (Application Programming Interface) এর মাধ্যমে ডেটা এক্সচেঞ্জ করার জন্য ব্যাপকভাবে ব্যবহৃত হয়। JSON এর মাধ্যমে ওয়েব API গুলি ডেটা রিসিভ ও পাঠাতে পারে, কারণ এটি মানব-পাঠযোগ্য এবং মেশিন-প্রসেসযোগ্য।

API গুলির মধ্যে JSON ব্যবহার করে Request (রিকোয়েস্ট) এবং Response (রেসপন্স) ম্যানেজমেন্টের প্রক্রিয়া খুবই সহজ ও কার্যকরী। এখানে, আমরা আলোচনা করব কিভাবে JSON API Request পাঠানো এবং JSON API Response প্রাপ্তি হয়।

JSON দিয়ে API Request এবং Response:

1. API Request Management (JSON)

API রিকোয়েস্ট পাঠানোর জন্য HTTP Request ব্যবহার করা হয় এবং JSON ফরম্যাটে ডেটা পাঠানো হয়। API রিকোয়েস্টে সাধারণত কিছু সাধারণ HTTP মেথড ব্যবহার করা হয়, যেমন GET, POST, PUT, DELETE ইত্যাদি।

GET Request Example (JSON)

GET রিকোয়েস্টের মাধ্যমে সাধারণত API থেকে ডেটা প্রাপ্তি করা হয়। এখানে আমরা JSON ফরম্যাটে API রিকোয়েস্ট পাঠাচ্ছি।

import requests

# API URL
url = "https://api.example.com/data"

# GET রিকোয়েস্ট
response = requests.get(url)

# JSON Response প্রাপ্তি
data = response.json()

# রেসপন্স প্রিন্ট
print(data)

ব্যাখ্যা:

• requests.get(url) GET রিকোয়েস্ট পাঠায় এবং response.json() ফাংশনটি রেসপন্সের JSON ডেটা প্রাপ্ত করে।
• response.json() রেসপন্সে পাওয়া JSON ডেটাকে Python Dictionary তে কনভার্ট করে।

POST Request Example (JSON)

POST রিকোয়েস্টের মাধ্যমে সাধারণত API-তে ডেটা পাঠানো হয়, যেমন কোনো নতুন রেকর্ড তৈরি করা। এখানে JSON ডেটা পাঠানো হচ্ছে।

import requests
import json

# API URL
url = "https://api.example.com/create"

# JSON ডেটা
data = {
    "name": "John",
    "age": 30,
    "city": "New York"
}

# POST রিকোয়েস্ট (JSON ডেটা পাঠানো)
response = requests.post(url, json=data)

# রেসপন্স প্রিন্ট
print(response.json())

ব্যাখ্যা:

• requests.post(url, json=data) POST রিকোয়েস্ট পাঠায় এবং JSON ডেটা API-তে পাঠায়।
• API রিকোয়েস্টের রেসপন্সও JSON ফরম্যাটে আসে।

2. API Response Management (JSON)

API রেসপন্স JSON ফরম্যাটে ফিরে আসে, যেটি সার্ভার থেকে প্রাপ্ত ডেটাকে ব্যবহারকারীর কাছে পাঠানোর জন্য ব্যবহৃত হয়। রেসপন্স JSON ফরম্যাটে বিভিন্ন ধরণের ডেটা যেমন স্ট্যাটাস, মেসেজ এবং মূল ডেটা অন্তর্ভুক্ত থাকতে পারে।

API Response Structure (JSON)

API রেসপন্সে সাধারণত ৩টি প্রধান অংশ থাকে:

• Status: API এর প্রসেসিং স্ট্যাটাস, যেমন Success বা Error।
• Message: API রেসপন্সের সাথে একটি মেসেজ।
• Data: প্রকৃত ডেটা যা API পাঠায়, যেমন ব্যবহারকারী তথ্য, পণ্য তালিকা ইত্যাদি।

JSON Response Example:

{
    "status": "success",
    "message": "Data retrieved successfully",
    "data": {
        "id": 1,
        "name": "John Doe",
        "email": "john.doe@example.com"
    }
}

API Response Parsing in Python

API রেসপন্সকে পার্স (parse) করার জন্য আমরা json() ফাংশন ব্যবহার করতে পারি।

import requests

# API URL
url = "https://api.example.com/user/1"

# GET রিকোয়েস্ট
response = requests.get(url)

# JSON রেসপন্স পার্স
data = response.json()

# JSON ডেটার প্রিন্ট
print("User Name:", data['data']['name'])
print("User Email:", data['data']['email'])

ব্যাখ্যা:

• response.json() API রেসপন্সের JSON ডেটাকে Python Dictionary তে কনভার্ট করে।
• এর পরে, আমরা data['data']['name'] বা data['data']['email'] ব্যবহার করে নির্দিষ্ট কীগুলির মান বের করতে পারি।

3. Error Handling in API Response

API রেসপন্সে যদি কোনো ত্রুটি ঘটে, তাহলে status বা message এর মাধ্যমে ত্রুটি বার্তা পাওয়া যায়।

Error Response Example:

{
    "status": "error",
    "message": "User not found",
    "data": null
}

Error Handling in Python

import requests

# API URL
url = "https://api.example.com/user/100"  # Non-existent user

# GET রিকোয়েস্ট
response = requests.get(url)

# রেসপন্স স্ট্যাটাস চেক করা
if response.status_code == 200:
    data = response.json()
    if data['status'] == 'error':
        print("Error:", data['message'])
    else:
        print("User Name:", data['data']['name'])
else:
    print("Failed to fetch data. HTTP Status Code:", response.status_code)

ব্যাখ্যা:

• response.status_code == 200 দিয়ে আমরা HTTP রেসপন্স কোড চেক করে থাকি।
• রেসপন্সে যদি status "error" থাকে, তবে ত্রুটি বার্তা প্রিন্ট করা হয়।

সারাংশ

JSON (JavaScript Object Notation) হল একটি লাইটওয়েট এবং মানব-পাঠযোগ্য ডেটা ফরম্যাট, যা API রিকোয়েস্ট এবং রেসপন্স ম্যানেজমেন্টে ব্যবহৃত হয়। Python এ JSON ডেটা পাঠানোর জন্য requests লাইব্রেরি ব্যবহার করে GET এবং POST রিকোয়েস্ট পাঠানো হয়, এবং API রেসপন্স JSON ফরম্যাটে প্রাপ্ত হয়। রেসপন্স ডেটা সহজে Python Dictionary তে রূপান্তর করা যায় এবং ডেটা ব্যবহার করা যায়। JSON এর মাধ্যমে API গুলি ডেটা এক্সচেঞ্জে একটি স্ট্যান্ডার্ড এবং কার্যকরী ফরম্যাট হিসেবে কাজ করে।