الهجرة من v2 إلى v3

// Your current v2 code:
$ch = curl_init('https://flexy-api.oneclickdz.com/v2/plans/listAll');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'authorization: YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

# Your current v2 code:
import requests

response = requests.get(
'https://flexy-api.oneclickdz.com/v2/plans/listAll',
headers={'authorization': 'YOUR_API_KEY'}
)

// Updated v3 code:
$ch = curl_init('https://api.oneclickdz.com/v3/mobile/plans');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Access-Token: YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

// Your current v2 code:
$ch = curl_init('https://flexy-api.oneclickdz.com/v2/account/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['authorization: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
echo "Balance: " . $data['balance']; // Direct access

# Your current v2 code:
response = requests.get(
    'https://flexy-api.oneclickdz.com/v2/account/balance',
    headers={'authorization': API_KEY}
)
data = response.json()
print(f"Balance: {data['balance']}")  # Direct access

// Updated v3 code:
const response = await fetch("https://api.oneclickdz.com/v3/account/balance", {
  headers: { "X-Access-Token": API_KEY },
});
const result = await response.json();

if (result.success) {
console.log("Balance:", result.data.balance);
console.log("Request ID:", result.requestId); // For debugging
console.log("Timestamp:", result.meta.timestamp); // Response time
} else {
console.error("Error:", result.error.message);
}

// Updated v3 code:
$ch = curl_init('https://api.oneclickdz.com/v3/account/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "Balance: " . $result['data']['balance'] . "\n";
    echo "Request ID: " . $result['requestId'] . "\n";
    echo "Timestamp: " . $result['meta']['timestamp'] . "\n";
} else {
    error_log("Error: " . $result['error']['message']);
}

# Updated v3 code:
response = requests.get(
    'https://api.oneclickdz.com/v3/account/balance',
    headers={'X-Access-Token': API_KEY}
)
result = response.json()

if result['success']:
print(f"Balance: {result['data']['balance']}")
print(f"Request ID: {result['requestId']}") # For debugging
print(f"Timestamp: {result['meta']['timestamp']}")
else:
print(f"Error: {result['error']['message']}")

// Your current v2 code:
$ch = curl_init('https://flexy-api.oneclickdz.com/v2/topup/sendTopup');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'authorization: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if (isset($result['error'])) {
error_log("Error: " . $result['message']); // Simple string
}

# Your current v2 code:
response = requests.post(
    'https://flexy-api.oneclickdz.com/v2/topup/sendTopup',
    headers={
        'Content-Type': 'application/json',
        'authorization': API_KEY
    },
    json=data
)
result = response.json()

if 'error' in result:
    print(f"Error: {result['message']}")  # Simple string

// Updated v3 code:
$ch = curl_init('https://api.oneclickdz.com/v3/mobile/send');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-Access-Token: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if (!$result['success']) {
    $errorCode = $result['error']['code'];
    $errorMessage = $result['error']['message'];
    error_log("Error [{$errorCode}]: {$errorMessage}");
    error_log("Request ID: " . $result['requestId']);

    // Handle specific errors
    switch ($errorCode) {
        case 'INSUFFICIENT_BALANCE':
            echo "Please top up your account\n";
            break;
        case 'ERR_PHONE':
            echo "Invalid phone number: {$errorMessage}\n";
            if (isset($result['error']['details']['pattern'])) {
                echo "Expected format: " . $result['error']['details']['pattern'] . "\n";
            }
            break;
        case 'DUPLICATED_REF':
            echo "This order reference was already used\n";
            break;
        default:
            echo "An error occurred. Please try again\n";
    }
}

# Updated v3 code:
response = requests.post(
    'https://api.oneclickdz.com/v3/mobile/send',
    headers={
        'Content-Type': 'application/json',
        'X-Access-Token': API_KEY
    },
    json=data
)
result = response.json()

if not result['success']:
error_code = result['error']['code']
error_message = result['error']['message']
print(f"Error [{error_code}]: {error_message}")
print(f"Request ID: {result['requestId']}")

    # Handle specific errors
    if error_code == 'INSUFFICIENT_BALANCE':
        print("Please top up your account")
    elif error_code == 'ERR_PHONE':
        print(f"Invalid phone number: {error_message}")
        if 'pattern' in result['error'].get('details', {}):
            print(f"Expected format: {result['error']['details']['pattern']}")
    elif error_code == 'DUPLICATED_REF':
        print("This order reference was already used")
    else:
        print("An error occurred. Please try again.")

$ch = curl_init('https://flexy-api.oneclickdz.com/v2/plans/listAll');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['authorization: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);

$dynamicPlans = $data['dymanicPlans']; // Note: typo in v2
$fixedPlans = $data['fixedPlans'];

response = requests.get(
    'https://flexy-api.oneclickdz.com/v2/plans/listAll',
    headers={'authorization': API_KEY}
)
data = response.json()

dynamic_plans = data['dymanicPlans']  # Note: typo in v2
fixed_plans = data['fixedPlans']

$ch = curl_init('https://api.oneclickdz.com/v3/mobile/plans');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    $dynamicPlans = $result['data']['dynamicPlans']; // Typo fixed!
    $fixedPlans = $result['data']['fixedPlans'];
}

response = requests.get(
    'https://api.oneclickdz.com/v3/mobile/plans',
    headers={'X-Access-Token': API_KEY}
)
result = response.json()

if result['success']:
dynamic_plans = result['data']['dynamicPlans'] # Typo fixed!
fixed_plans = result['data']['fixedPlans']

$data = [
    'plan_code' => 'PREPAID_DJEZZY',
    'MSSIDN' => '0778037340',
    'amount' => 500,
    'ref' => 'order-123'
];

$ch = curl_init('https://flexy-api.oneclickdz.com/v2/topup/sendTopup');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'authorization: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

echo "Topup ID: " . $result['topupId'] . "\n";
echo "New Balance: " . $result['newBalance'] . "\n";

data = {
    'plan_code': 'PREPAID_DJEZZY',
    'MSSIDN': '0778037340',
    'amount': 500,
    'ref': 'order-123'
}

response = requests.post(
    'https://flexy-api.oneclickdz.com/v2/topup/sendTopup',
    headers={
        'Content-Type': 'application/json',
        'authorization': API_KEY
    },
    json=data
)
result = response.json()

print(f"Topup ID: {result['topupId']}")
print(f"New Balance: {result['newBalance']}")

// ...existing code...

$ch = curl_init('https://api.oneclickdz.com/v3/mobile/send');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-Access-Token: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "✅ Top-up sent successfully!\n";
    echo "Topup ID: " . $result['data']['topupId'] . "\n";
    echo "New Balance: " . $result['data']['newBalance'] . "\n";
    echo "Request ID: " . $result['requestId'] . "\n";
} else {
    error_log("❌ Error [{$result['error']['code']}]: {$result['error']['message']}");
    error_log("Request ID: " . $result['requestId']);
}

# ...existing code...

response = requests.post(
'https://api.oneclickdz.com/v3/mobile/send',
headers={
'Content-Type': 'application/json',
'X-Access-Token': API_KEY
},
json=data
)
result = response.json()

if result['success']:
print("✅ Top-up sent successfully!")
print(f"Topup ID: {result['data']['topupId']}")
print(f"New Balance: {result['data']['newBalance']}")
print(f"Request ID: {result['requestId']}")
else:
print(f"❌ Error [{result['error']['code']}]: {result['error']['message']}")
print(f"Request ID: {result['requestId']}")

$ch = curl_init('https://flexy-api.oneclickdz.com/v2/topup/checkStatus/REF/order-123');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['authorization: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);

echo "Status: " . $data['topup']['status'] . "\n";
echo "Phone: " . $data['topup']['MSSIDN'] . "\n";

response = requests.get(
    'https://flexy-api.oneclickdz.com/v2/topup/checkStatus/REF/order-123',
    headers={'authorization': API_KEY}
)
data = response.json()

print(f"Status: {data['topup']['status']}")
print(f"Phone: {data['topup']['MSSIDN']}")

$ch = curl_init('https://api.oneclickdz.com/v3/mobile/check-ref/order-123');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "Status: " . $result['data']['status'] . "\n";
    echo "Phone: " . $result['data']['MSSIDN'] . "\n";

    // New in v3: Enhanced refund information
    if ($result['data']['status'] === 'REFUNDED') {
        echo "❌ Top-up was refunded\n";
        echo "Reason: " . $result['data']['refund_message'] . "\n";
        if (isset($result['data']['suggested_offers'])) {
            echo "💡 Try these offers instead:\n";
            print_r($result['data']['suggested_offers']);
        }
    } elseif ($result['data']['status'] === 'FULFILLED') {
        echo "✅ Top-up completed successfully\n";
    }
}

response = requests.get(
    'https://api.oneclickdz.com/v3/mobile/check-ref/order-123',
    headers={'X-Access-Token': API_KEY}
)
result = response.json()

if result['success']:
print(f"Status: {result['data']['status']}")
print(f"Phone: {result['data']['MSSIDN']}")

    # New in v3: Enhanced refund information
    if result['data']['status'] == 'REFUNDED':
        print("❌ Top-up was refunded")
        print(f"Reason: {result['data']['refund_message']}")
        if 'suggested_offers' in result['data']:
            print("💡 Try these offers instead:")
            print(result['data']['suggested_offers'])
    elif result['data']['status'] == 'FULFILLED':
        print("✅ Top-up completed successfully")

$ch = curl_init('https://flexy-api.oneclickdz.com/v2/account/transactions?page=1&pageSize=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['authorization: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);

echo "Transactions: " . count($data['transactions']) . "\n";
echo "Total: " . $data['totalResults'] . "\n";
echo "Page: " . $data['currentPage'] . "\n";
echo "Pages: " . $data['totalPages'] . "\n";

response = requests.get(
    'https://flexy-api.oneclickdz.com/v2/account/transactions?page=1&pageSize=20',
    headers={'authorization': API_KEY}
)
data = response.json()

print(f"Transactions: {len(data['transactions'])}")
print(f"Total: {data['totalResults']}")
print(f"Page: {data['currentPage']}")
print(f"Pages: {data['totalPages']}")

$ch = curl_init('https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "Transactions: " . count($result['data']['items']) . "\n";
    echo "Total: " . $result['data']['pagination']['totalResults'] . "\n";
    echo "Page: " . $result['data']['pagination']['page'] . "\n";
    echo "Pages: " . $result['data']['pagination']['totalPages'] . "\n";
    echo "Page Size: " . $result['data']['pagination']['pageSize'] . "\n";
}

response = requests.get(
    'https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20',
    headers={'X-Access-Token': API_KEY}
)
result = response.json()

if result['success']:
print(f"Transactions: {len(result['data']['items'])}")
print(f"Total: {result['data']['pagination']['totalResults']}")
print(f"Page: {result['data']['pagination']['page']}")
print(f"Pages: {result['data']['pagination']['totalPages']}")
print(f"Page Size: {result['data']['pagination']['pageSize']}")

$ch = curl_init('https://flexy-api.oneclickdz.com/v2/internet/checkCards/ADSL');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['authorization: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$cards = json_decode($response, true); // Direct array

foreach ($cards as $card) {
echo $card['value'] . " DA - Available: " . $card['available'] . "\n";
}

response = requests.get(
    'https://flexy-api.oneclickdz.com/v2/internet/checkCards/ADSL',
    headers={'authorization': API_KEY}
)
cards = response.json()  # Direct array

for card in cards:
    print(f"{card['value']} DA - Available: {card['available']}")

$ch = curl_init('https://api.oneclickdz.com/v3/internet/products?type=ADSL');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    foreach ($result['data']['products'] as $card) {
        echo $card['value'] . " DA - Available: " . $card['available'] . "\n";
    }
}

response = requests.get(
    'https://api.oneclickdz.com/v3/internet/products?type=ADSL',
    headers={'X-Access-Token': API_KEY}
)
result = response.json()

if result['success']:
for card in result['data']['products']:
print(f"{card['value']} DA - Available: {card['available']}")

class FlexyAPI {
    private $apiKey;
    private $baseUrl = 'https://flexy-api.oneclickdz.com';

    public function __construct($apiKey) {
        $this->apiKey = $apiKey;
    }

    private function request($endpoint, $options = []) {
        $ch = curl_init($this->baseUrl . $endpoint);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'authorization: ' . $this->apiKey
        ]);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

        if (isset($options['method']) && $options['method'] === 'POST') {
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $options['body']);
        }

        $response = curl_exec($ch);
        return json_decode($response, true);
    }

    public function getBalance() {
        $data = $this->request('/v2/account/balance');
        return $data['balance'];
    }

    public function sendTopup($params) {
        return $this->request('/v2/topup/sendTopup', [
            'method' => 'POST',
            'body' => json_encode($params)
        ]);
    }

}

import requests

class FlexyAPI:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = 'https://flexy-api.oneclickdz.com'

    def request(self, endpoint, method='GET', data=None):
        headers = {'authorization': self.api_key}
        url = f"{self.base_url}{endpoint}"

        if method == 'GET':
            response = requests.get(url, headers=headers)
        else:
            headers['Content-Type'] = 'application/json'
            response = requests.post(url, headers=headers, json=data)

        return response.json()

    def get_balance(self):
        data = self.request('/v2/account/balance')
        return data['balance']

    def send_topup(self, params):
        return self.request('/v2/topup/sendTopup', method='POST', data=params)

class FlexyAPI {
    private $apiKey;
    private $baseUrl = 'https://api.oneclickdz.com';

    public function __construct($apiKey) {
        $this->apiKey = $apiKey;
    }

    private function request($endpoint, $options = []) {
        $ch = curl_init($this->baseUrl . $endpoint);
        $headers = ['X-Access-Token: ' . $this->apiKey]; // Changed header name

        if (isset($options['method']) && $options['method'] === 'POST') {
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $options['body']);
            $headers[] = 'Content-Type: application/json';
        }

        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        $response = curl_exec($ch);
        $result = json_decode($response, true);

        // Handle v3 response wrapper
        if (!$result['success']) {
            $error = [
                'message' => $result['error']['message'],
                'code' => $result['error']['code'],
                'details' => $result['error']['details'] ?? null,
                'requestId' => $result['requestId']
            ];
            throw new Exception(json_encode($error));
        }

        return $result['data']; // Return unwrapped data
    }

    public function getBalance() {
        $data = $this->request('/v3/account/balance'); // Updated path
        return $data['balance'];
    }

    public function sendTopup($params) {
        return $this->request('/v3/mobile/send', [ // Updated path
            'method' => 'POST',
            'body' => json_encode($params)
        ]);
    }
}

import requests

class FlexyAPIError(Exception):
"""Custom exception for API errors"""
def **init**(self, message, code, details=None, request_id=None):
super().**init**(message)
self.code = code
self.details = details
self.request_id = request_id

class FlexyAPI:
def **init**(self, api_key):
self.api_key = api_key
self.base_url = 'https://api.oneclickdz.com'

    def request(self, endpoint, method='GET', data=None):
        headers = {'X-Access-Token': self.api_key}  # Changed header name
        url = f"{self.base_url}{endpoint}"

        if method == 'GET':
            response = requests.get(url, headers=headers)
        else:
            headers['Content-Type'] = 'application/json'
            response = requests.post(url, headers=headers, json=data)

        result = response.json()

        # Handle v3 response wrapper
        if not result['success']:
            raise FlexyAPIError(
                result['error']['message'],
                result['error']['code'],
                result['error'].get('details'),
                result['requestId']
            )

        return result['data']  # Return unwrapped data

    def get_balance(self):
        data = self.request('/v3/account/balance')  # Updated path
        return data['balance']

    def send_topup(self, params):
        return self.request('/v3/mobile/send', method='POST', data=params)  # Updated path

// v2 way:
if ($result['error'] === 'NO-BALANCE') {
    // handle
}

// v3 way:
if (!$result['success'] && $result['error']['code'] === 'INSUFFICIENT_BALANCE') {
    error_log("Request ID: " . $result['requestId']); // Save for support
    // handle with more context
    if (isset($result['error']['details']['currentBalance'])) {
echo "Current balance: " . $result['error']['details']['currentBalance'] . "\n";
}
}

# v2 way:
if result.get('error') == 'NO-BALANCE':
    # handle

# v3 way:
if not result['success'] and result['error']['code'] == 'INSUFFICIENT_BALANCE':
    print(f"Request ID: {result['requestId']}")  # Save for support
    # handle with more context
    if 'currentBalance' in result['error'].get('details', {}):
        print(f"Current balance: {result['error']['details']['currentBalance']}")

// Updated v3 code:
$ch = curl_init('https://api.oneclickdz.com/v3/account/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "Balance: " . $result['data']['balance'] . "\n";
    echo "Request ID: " . $result['requestId'] . "\n";
    echo "Timestamp: " . $result['meta']['timestamp'] . "\n";
} else {
    error_log("Error: " . $result['error']['message']);
}