خطوات المصادقة
1. تسجيل الدخول
POST
/api/v1/login
{
"email": "your-email@example.com",
"password": "your-password"
}
سيتم إرجاع token للمصادقة في حال نجاح تسجيل الدخول.
2. استخدام Token في الطلبات
يجب إضافة التوكن في رأس الطلب (Header) لجميع الطلبات التي تتطلب مصادقة:
Authorization: Bearer <your-token>
مثال على طلب مصادق:
POST
/api/v1/orders
// Headers
{
"Authorization": "Bearer your-token-here",
"Content-Type": "application/json"
}
// Body
{
"items": [
{
"product_id": 1,
"quantity": 2
}
]
}
ملاحظة هامة: جميع الطلبات التي تتطلب مصادقة ستعيد رمز خطأ 401 في حال عدم وجود توكن صحيح.
أمثلة على الربط بلغات البرمجة المختلفة
مثال بلغة Python
import requests
# تسجيل الدخول والحصول على التوكن
def login():
login_url = "https://your-domain.com/api/v1/login"
credentials = {
"email": "your-email@example.com",
"password": "your-password"
}
response = requests.post(login_url, json=credentials)
if response.status_code == 200:
return response.json()["token"]
return None
# إنشاء طلب جديد
def create_order(token):
orders_url = "https://your-domain.com/api/v1/orders"
headers = {
"Authorization": f"Bearer {token}",
"Content-Type": "application/json"
}
order_data = {
"items": [
{
"product_id": 1,
"quantity": 2
}
]
}
response = requests.post(orders_url, headers=headers, json=order_data)
return response.json()
# استخدام الدوال
token = login()
if token:
order_result = create_order(token)
print(order_result)مثال بلغة PHP
<?php
// تسجيل الدخول والحصول على التوكن
function login() {
$login_url = "https://your-domain.com/api/v1/login";
$credentials = array(
"email" => "your-email@example.com",
"password" => "your-password"
);
$ch = curl_init($login_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($credentials));
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
return isset($result['token']) ? $result['token'] : null;
}
// إنشاء طلب جديد
function create_order($token) {
$orders_url = "https://your-domain.com/api/v1/orders";
$order_data = array(
"items" => array(
array(
"product_id" => 1,
"quantity" => 2
)
)
);
$ch = curl_init($orders_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($order_data));
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Authorization: Bearer ' . $token
));
$response = curl_exec($ch);
curl_close($ch);
return json_decode($response, true);
}
// استخدام الدوال
$token = login();
if ($token) {
$order_result = create_order($token);
print_r($order_result);
}
?>