وثائق واجهة برمجة التطبيقات

curl -X POST "https://i3rbly.com/api/v3/tool" \
     -H "Content-Type: application/json" \
     -d '{"key": "YOUR_API_KEY", "phrase": "الولدُ يلعبُ بالكرةِ"}'

curl "https://i3rbly.com/api/v3/status?key=YOUR_API_KEY"

import requests
import json

API_URL = "https://i3rbly.com/api/v3/tool"
API_KEY = "YOUR_API_KEY"  # Replace with your actual key

def get_irab(sentence):
    """
    Calls the i3rbly API to get the I'rab of a sentence.
    """
    headers = {
        'Content-Type': 'application/json'
    }
    payload = {
        'key': API_KEY,
        'phrase': sentence
    }

    try:
        response = requests.post(API_URL, headers=headers, data=json.dumps(payload))
        response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)
        return response.json()
    except requests.exceptions.HTTPError as err:
        print(f"HTTP Error: {err}")
        # Try to print the error response from the API
        try:
            print("API Response:", err.response.json())
        except json.JSONDecodeError:
            print("API Response (raw):", err.response.text)
        return None
    except requests.exceptions.RequestException as err:
        print(f"Request Error: {err}")
        return None

if __name__ == "__main__":
    arabic_sentence = "الشمسُ مشرقةٌ في السماءِ"
    result = get_irab(arabic_sentence)
    if result and 'إعراب' in result:
        print(f"إعراب جملة: '{arabic_sentence}'\n" + "="*30)
        for item in result['إعراب']:
            print(f"{item['الكلمة']}: {item['الإعراب']}")
        
        print("\n" + "="*30)
        print(f"الإصدار: {result.get('الإصدار')}")
        print(f"الطلبات المتبقية هذا الساعة: {result.get('الطلبات_المتبقية')}")