توثيق API التوصيل

<?php

$apiKey = 'YOUR_API_KEY_HERE';
$url = 'https://essalmy.com/api/delivery.php?action=orders&filter=available';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: ' . $apiKey,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

curl_close($ch);
print_r($data);

import requests

api_key = 'YOUR_API_KEY_HERE'
url = 'https://essalmy.com/api/delivery.php'

headers = {
    'X-API-Key': api_key,
    'Content-Type': 'application/json'
}

params = {
    'action': 'orders',
    'filter': 'available'
}

response = requests.get(url, headers=headers, params=params)
data = response.json()
print(data)

const apiKey = 'YOUR_API_KEY_HERE';
const url = 'https://essalmy.com/api/delivery.php';

const params = new URLSearchParams({
    action: 'orders',
    filter: 'available'
});

const response = await fetch(`${url}?${params}`, {
    method: 'GET',
    headers: {
        'X-API-Key': apiKey,
        'Content-Type': 'application/json'
    }
});

const data = await response.json();
console.log(data);

final response = await http.get(
  Uri.parse('https://essalmy.com/api/delivery.php?action=orders'),
  headers: {
    'X-API-Key': 'YOUR_API_KEY_HERE',
    'Content-Type': 'application/json',
  },
);
final data = json.decode(response.body);
print(data);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://essalmy.com/api/delivery.php?action=orders"))
    .header("X-API-Key", "YOUR_API_KEY_HERE")
    .header("Content-Type", "application/json")
    .GET()
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());

client.DefaultRequestHeaders.Add("X-API-Key", "YOUR_API_KEY_HERE");

var response = await client.GetAsync(
    "https://essalmy.com/api/delivery.php?action=orders"
);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);

uri = URI('https://essalmy.com/api/delivery.php?action=orders')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['X-API-Key'] = 'YOUR_API_KEY_HERE'

response = http.request(request)
puts JSON.parse(response.body)

req, _ := http.NewRequest("GET",
    "https://essalmy.com/api/delivery.php?action=orders", nil)
req.Header.Set("X-API-Key", "YOUR_API_KEY_HERE")

client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

var request = URLRequest(url: URL(string: "https://essalmy.com/api/delivery.php?action=orders")!)
request.httpMethod = "GET"
request.setValue("YOUR_API_KEY_HERE", forHTTPHeaderField: "X-API-Key")

URLSession.shared.dataTask(with: request) { data, response, error in
    guard let data = data else { return }
    if let json = try? JSONSerialization.jsonObject(with: data) {
        print(json)
    }
}.resume()

import requests

API_KEY = 'YOUR_API_KEY_HERE'
BASE_URL = 'https://essalmy.com/api/delivery.php'

headers = {
    'X-API-Key': API_KEY,
    'Content-Type': 'application/json'
}

# 1. جلب الطلبات المتاحة
print("=== جلب الطلبات المتاحة ===")
response = requests.get(
    BASE_URL,
    headers=headers,
    params={'action': 'orders', 'filter': 'available'}
)
print(response.json())

# 2. تكليف الطلب
print("\n=== تكليف الطلب ===")
response = requests.post(
    f"{BASE_URL}?action=assign",
    headers=headers,
    json={'order_id': 1234}
)
print(response.json())

# 3. تحديث الحالة إلى "في الطريق"
print("\n=== تحديث الحالة ===")
response = requests.post(
    f"{BASE_URL}?action=update_status",
    headers=headers,
    json={
        'order_id': 1234,
        'status': 'in_transit',
        'location': 'شارع الأمير سلطان، الرياض',
        'notes': 'السائق في الطريق'
    }
)
print(response.json())

# 4. تسليم الطلب
print("\n=== تسليم الطلب ===")
response = requests.post(
    f"{BASE_URL}?action=deliver",
    headers=headers,
    json={
        'order_id': 1234,
        'notes': 'تم التسليم للعميل'
    }
)
                            print(response.json())

import 'dart:convert';
import 'package:http/http.dart' as http;

class DeliveryApiService {
  final String apiKey = 'YOUR_API_KEY_HERE';
  final String baseUrl = 'https://essalmy.com/api/delivery.php';

  // جلب الطلبات المتاحة
  Future<Map<String, dynamic>> getAvailableOrders({int page = 1}) async {
    final response = await http.get(
      Uri.parse('$baseUrl?action=orders&filter=available&page=$page'),
      headers: {
        'X-API-Key': apiKey,
        'Content-Type': 'application/json',
      },
    );
    return json.decode(response.body);
  }

  // تكليف الطلب
  Future<Map<String, dynamic>> assignOrder(int orderId) async {
    final response = await http.post(
      Uri.parse('$baseUrl?action=assign'),
      headers: {
        'X-API-Key': apiKey,
        'Content-Type': 'application/x-www-form-urlencoded',
      },
      body: {'order_id': orderId.toString()},
    );
    return json.decode(response.body);
  }

  // تحديث الحالة
  Future<Map<String, dynamic>> updateStatus(
    int orderId, String status, {String? location, String? notes}
  ) async {
    final body = {
      'order_id': orderId.toString(),
      'status': status,
    };
    if (location != null) body['location'] = location;
    if (notes != null) body['notes'] = notes;

    final response = await http.post(
      Uri.parse('$baseUrl?action=update_status'),
      headers: {
        'X-API-Key': apiKey,
        'Content-Type': 'application/x-www-form-urlencoded',
      },
      body: body,
    );
    return json.decode(response.body);
  }

  // تسليم الطلب
  Future<Map<String, dynamic>> deliverOrder(int orderId, {String? notes}) async {
    final body = {'order_id': orderId.toString()};
    if (notes != null) body['notes'] = notes;

    final response = await http.post(
      Uri.parse('$baseUrl?action=deliver'),
      headers: {
        'X-API-Key': apiKey,
        'Content-Type': 'application/x-www-form-urlencoded',
      },
      body: body,
    );
    return json.decode(response.body);
  }

  // جلب الإحصائيات
  Future<Map<String, dynamic>> getStats() async {
    final response = await http.get(
      Uri.parse('$baseUrl?action=stats'),
      headers: {
        'X-API-Key': apiKey,
        'Content-Type': 'application/json',
      },
    );
    return json.decode(response.body);
  }
}

// مثال الاستخدام
void main() async {
  final api = DeliveryApiService();

  // جلب الطلبات
  final orders = await api.getAvailableOrders();
  print(orders);

  // تكليف طلب
  final assign = await api.assignOrder(1234);
  print(assign);
}

import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

public class DeliveryApiClient {
    private static final String API_KEY = "YOUR_API_KEY_HERE";
    private static final String BASE_URL = "https://essalmy.com/api/delivery.php";
    private static final HttpClient client = HttpClient.newBuilder().build();

    // جلب الطلبات المتاحة
    public static String getAvailableOrders() throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "?action=orders&filter=available"))
            .header("X-API-Key", API_KEY)
            .header("Content-Type", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        return response.body();
    }

    // تكليف الطلب
    public static String assignOrder(int orderId) throws Exception {
        String body = "order_id=" + orderId;

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "?action=assign"))
            .header("X-API-Key", API_KEY)
            .header("Content-Type", "application/x-www-form-urlencoded")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        return response.body();
    }

    // تحديث الحالة
    public static String updateStatus(int orderId, String status, String location) throws Exception {
        String body = "order_id=" + orderId
            + "&status=" + URLEncoder.encode(status, StandardCharsets.UTF_8)
            + "&location=" + URLEncoder.encode(location, StandardCharsets.UTF_8);

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "?action=update_status"))
            .header("X-API-Key", API_KEY)
            .header("Content-Type", "application/x-www-form-urlencoded")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        return response.body();
    }

    // تسليم الطلب
    public static String deliverOrder(int orderId, String notes) throws Exception {
        String body = "order_id=" + orderId
            + "¬es=" + URLEncoder.encode(notes, StandardCharsets.UTF_8);

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "?action=deliver"))
            .header("X-API-Key", API_KEY)
            .header("Content-Type", "application/x-www-form-urlencoded")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        return response.body();
    }

    public static void main(String[] args) throws Exception {
        System.out.println(getAvailableOrders());
        System.out.println(assignOrder(1234));
    }
}

using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;

public class DeliveryApiClient
{
    private const string API_KEY = "YOUR_API_KEY_HERE";
    private const string BASE_URL = "https://essalmy.com/api/delivery.php";
    private static readonly HttpClient client = new HttpClient();

    // جلب الطلبات المتاحة
    public static async Task<string> GetAvailableOrdersAsync()
    {
        client.DefaultRequestHeaders.Remove("X-API-Key");
        client.DefaultRequestHeaders.Add("X-API-Key", API_KEY);

        var response = await client.GetAsync(
            $"{BASE_URL}?action=orders&filter=available"
        );
        return await response.Content.ReadAsStringAsync();
    }

    // تكليف الطلب
    public static async Task<string> AssignOrderAsync(int orderId)
    {
        client.DefaultRequestHeaders.Remove("X-API-Key");
        client.DefaultRequestHeaders.Add("X-API-Key", API_KEY);

        var body = new StringContent(
            $"order_id={orderId}",
            Encoding.UTF8,
            "application/x-www-form-urlencoded"
        );

        var response = await client.PostAsync(
            $"{BASE_URL}?action=assign", body
        );
        return await response.Content.ReadAsStringAsync();
    }

    // تحديث الحالة
    public static async Task<string> UpdateStatusAsync(
        int orderId, string status, string location
    )
    {
        client.DefaultRequestHeaders.Remove("X-API-Key");
        client.DefaultRequestHeaders.Add("X-API-Key", API_KEY);

        var body = new StringContent(
            $"order_id={orderId}&status={status}&location={Uri.EscapeDataString(location)}",
            Encoding.UTF8,
            "application/x-www-form-urlencoded"
        );

        var response = await client.PostAsync(
            $"{BASE_URL}?action=update_status", body
        );
        return await response.Content.ReadAsStringAsync();
    }

    // تسليم الطلب
    public static async Task<string> DeliverOrderAsync(int orderId, string notes)
    {
        client.DefaultRequestHeaders.Remove("X-API-Key");
        client.DefaultRequestHeaders.Add("X-API-Key", API_KEY);

        var body = new StringContent(
            $"order_id={orderId}¬es={Uri.EscapeDataString(notes)}",
            Encoding.UTF8,
            "application/x-www-form-urlencoded"
        );

        var response = await client.PostAsync(
            $"{BASE_URL}?action=deliver", body
        );
        return await response.Content.ReadAsStringAsync();
    }

    public static async Task Main()
    {
        Console.WriteLine(await GetAvailableOrdersAsync());
        Console.WriteLine(await AssignOrderAsync(1234));
    }
}

require 'net/http'
require 'json'
require 'uri'

API_KEY = 'YOUR_API_KEY_HERE'
BASE_URL = 'https://essalmy.com/api/delivery.php'

def make_request(action, method = 'GET', params = {})
  uri = URI("#{BASE_URL}?action=#{action}")
  uri.query = URI.encode_www_form(params) if method == 'GET' && !params.empty?

  http = Net::HTTP.new(uri.host, uri.port)
  http.use_ssl = true

  if method == 'GET'
    request = Net::HTTP::Get.new(uri)
  else
    request = Net::HTTP::Post.new(uri)
    request.set_form_data(params)
  end

  request['X-API-Key'] = API_KEY
  response = http.request(request)
  JSON.parse(response.body)
end

# 1. جلب الطلبات المتاحة
puts "=== جلب الطلبات المتاحة ==="
result = make_request('orders', 'GET', { 'filter' => 'available' })
puts result

# 2. تكليف الطلب
puts "\n=== تكليف الطلب ==="
result = make_request('assign', 'POST', { 'order_id' => 1234 })
puts result

# 3. تحديث الحالة
puts "\n=== تحديث الحالة ==="
result = make_request('update_status', 'POST', {
  'order_id'  => 1234,
  'status'    => 'in_transit',
  'location'  => 'شارع الأمير سلطان، الرياض',
  'notes'     => 'السائق في الطريق'
})
puts result

# 4. تسليم الطلب
puts "\n=== تسليم الطلب ==="
result = make_request('deliver', 'POST', {
  'order_id' => 1234,
  'notes'    => 'تم التسليم للعميل'
})
puts result

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "net/url"
)

const (
    apiKey  = "YOUR_API_KEY_HERE"
    baseURL = "https://essalmy.com/api/delivery.php"
)

func makeRequest(endpoint string, method string, data map[string]string) (map[string]interface{}, error) {
    fullURL := baseURL + "?action=" + endpoint

    var req *http.Request
    var err error

    if method == "GET" {
        params := url.Values{}
        for k, v := range data {
            params.Set(k, v)
        }
        fullURL += "&" + params.Encode()
        req, err = http.NewRequest("GET", fullURL, nil)
    } else {
        form := url.Values{}
        for k, v := range data {
            form.Set(k, v)
        }
        req, err = http.NewRequest("POST", fullURL, bytes.NewBufferString(form.Encode()))
    }

    if err != nil {
        return nil, err
    }

    req.Header.Set("X-API-Key", apiKey)
    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        return nil, err
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    var result map[string]interface{}
    json.Unmarshal(body, &result)

    return result, nil
}

func main() {
    // جلب الطلبات المتاحة
    fmt.Println("=== جلب الطلبات المتاحة ===")
    orders, _ := makeRequest("orders", "GET", map[string]string{"filter": "available"})
    fmt.Println(orders)

    // تكليف الطلب
    fmt.Println("\n=== تكليف الطلب ===")
    result, _ := makeRequest("assign", "POST", map[string]string{"order_id": "1234"})
    fmt.Println(result)

    // تحديث الحالة
    fmt.Println("\n=== تحديث الحالة ===")
    result, _ = makeRequest("update_status", "POST", map[string]string{
        "order_id": "1234",
        "status":   "in_transit",
        "location": "شارع الأمير سلطان، الرياض",
    })
    fmt.Println(result)

    // تسليم الطلب
    fmt.Println("\n=== تسليم الطلب ===")
    result, _ = makeRequest("deliver", "POST", map[string]string{
        "order_id": "1234",
        "notes":    "تم التسليم للعميل",
    })
    fmt.Println(result)
}

import Foundation

class DeliveryApiClient {
    let apiKey = "YOUR_API_KEY_HERE"
    let baseUrl = "https://essalmy.com/api/delivery.php"

    // جلب الطلبات المتاحة
    func getAvailableOrders(completion: @escaping ([String: Any]?) -> Void) {
        let urlString = "\(baseUrl)?action=orders&filter=available"
        guard let url = URL(string: urlString) else { return }

        var request = URLRequest(url: url)
        request.httpMethod = "GET"
        request.setValue(apiKey, forHTTPHeaderField: "X-API-Key")
        request.setValue("application/json", forHTTPHeaderField: "Content-Type")

        URLSession.shared.dataTask(with: request) { data, response, error in
            guard let data = data,
                  let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
            else {
                completion(nil)
                return
            }
            completion(json)
        }.resume()
    }

    // تكليف الطلب
    func assignOrder(orderId: Int, completion: @escaping ([String: Any]?) -> Void) {
        let urlString = "\(baseUrl)?action=assign"
        guard let url = URL(string: urlString) else { return }

        var request = URLRequest(url: url)
        request.httpMethod = "POST"
        request.setValue(apiKey, forHTTPHeaderField: "X-API-Key")
        request.setValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
        request.httpBody = "order_id=\(orderId)".data(using: .utf8)

        URLSession.shared.dataTask(with: request) { data, response, error in
            guard let data = data,
                  let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
            else {
                completion(nil)
                return
            }
            completion(json)
        }.resume()
    }

    // تحديث الحالة
    func updateStatus(orderId: Int, status: String, location: String,
                       completion: @escaping ([String: Any]?) -> Void) {
        let urlString = "\(baseUrl)?action=update_status"
        guard let url = URL(string: urlString) else { return }

        var request = URLRequest(url: url)
        request.httpMethod = "POST"
        request.setValue(apiKey, forHTTPHeaderField: "X-API-Key")
        request.setValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")

        let body = "order_id=\(orderId)&status=\(status)&location=\(location)"
        request.httpBody = body.data(using: .utf8)

        URLSession.shared.dataTask(with: request) { data, response, error in
            guard let data = data,
                  let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
            else {
                completion(nil)
                return
            }
            completion(json)
        }.resume()
    }

    // تسليم الطلب
    func deliverOrder(orderId: Int, notes: String,
                     completion: @escaping ([String: Any]?) -> Void) {
        let urlString = "\(baseUrl)?action=deliver"
        guard let url = URL(string: urlString) else { return }

        var request = URLRequest(url: url)
        request.httpMethod = "POST"
        request.setValue(apiKey, forHTTPHeaderField: "X-API-Key")
        request.setValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")

        let body = "order_id=\(orderId)¬es=\(notes)"
        request.httpBody = body.data(using: .utf8)

        URLSession.shared.dataTask(with: request) { data, response, error in
            guard let data = data,
                  let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
            else {
                completion(nil)
                return
            }
            completion(json)
        }.resume()
    }
}

// مثال الاستخدام
let api = DeliveryApiClient()
api.getAvailableOrders { result in
    print(result ?? "Error")
}