API Publique de Tracking

Intégrez le suivi de colis SAMATELIMAN dans votre site web ou application. L'API est gratuite, publique, et ne nécessite aucune authentification.

Endpoint

URL de l'API de tracking

Méthode HTTP

GET

URL

https://sama-logi-o5vcingh.manus.space/api/public/track/:trackingNumber

Paramètres

Nom	Type	Description
`trackingNumber`	string	Numéro de suivi du colis (ex: 90001)

Format de Réponse

Structure JSON retournée par l'API

{
  "success": true,
  "data": {
    "trackingNumber": "90001",
    "status": "delivered",
    "sender": {
      "name": "Jean Dupont",
      "phone": "+223 70 00 00 00"
    },
    "recipient": {
      "name": "Marie Traoré",
      "phone": "+223 70 00 00 01"
    },
    "destination": "Bamako",
    "type": "electronics",
    "quantity": 1,
    "weight": 2.5,
    "volume": 0.05,
    "price": 50000,
    "storageLocation": "warehouse_1",
    "photoUrl": "https://storage.example.com/photos/90001.jpg",
    "notes": "Fragile - Handle with care",
    "createdAt": "2024-01-01T10:00:00.000Z",
    "updatedAt": "2024-01-02T15:30:00.000Z",
    "movements": []
  }
}

Exemples d'Intégration

cURL

curl "https://sama-logi-o5vcingh.manus.space/api/public/track/90001"

JavaScript (Fetch API)

fetch('https://sama-logi-o5vcingh.manus.space/api/public/track/90001')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('Tracking Number:', data.data.trackingNumber);
      console.log('Status:', data.data.status);
      console.log('Recipient:', data.data.recipient.name);
    } else {
      console.error('Error:', data.error);
    }
  })
  .catch(error => console.error('Request failed:', error));

JavaScript (Async/Await)

async function trackPackage(trackingNumber) {
  try {
    const response = await fetch(`https://sama-logi-o5vcingh.manus.space/api/public/track/${trackingNumber}`);
    const data = await response.json();
    
    if (data.success) {
      return data.data;
    } else {
      throw new Error(data.error);
    }
  } catch (error) {
    console.error('Tracking failed:', error);
    return null;
  }
}

// Usage
const packageInfo = await trackPackage('90001');
console.log(packageInfo);

PHP

<?php
$trackingNumber = '90001';
$url = 'https://sama-logi-o5vcingh.manus.space/api/public/track/' . $trackingNumber;

$response = file_get_contents($url);
$data = json_decode($response, true);

if ($data['success']) {
    echo "Numéro de suivi: " . $data['data']['trackingNumber'] . "\n";
    echo "Statut: " . $data['data']['status'] . "\n";
    echo "Destinataire: " . $data['data']['recipient']['name'] . "\n";
} else {
    echo "Erreur: " . $data['error'] . "\n";
}
?>

Python

import requests

def track_package(tracking_number):
    url = f'https://sama-logi-o5vcingh.manus.space/api/public/track/{tracking_number}'
    
    try:
        response = requests.get(url)
        data = response.json()
        
        if data['success']:
            return data['data']
        else:
            print(f"Error: {data['error']}")
            return None
    except Exception as e:
        print(f"Request failed: {e}")
        return None

# Usage
package_info = track_package('90001')
if package_info:
    print(f"Tracking Number: {package_info['trackingNumber']}")
    print(f"Status: {package_info['status']}")
    print(f"Recipient: {package_info['recipient']['name']}")

jQuery

$.ajax({
  url: 'https://sama-logi-o5vcingh.manus.space/api/public/track/90001',
  method: 'GET',
  dataType: 'json',
  success: function(data) {
    if (data.success) {
      $('#tracking-number').text(data.data.trackingNumber);
      $('#status').text(data.data.status);
      $('#recipient').text(data.data.recipient.name);
    } else {
      alert('Erreur: ' + data.error);
    }
  },
  error: function(xhr, status, error) {
    console.error('Request failed:', error);
  }
});

Gestion des Erreurs

Codes d'erreur et messages

Code HTTP	Message	Description
`200`	Success	Colis trouvé avec succès
`400`	Tracking number is required	Numéro de suivi manquant
`404`	Package not found	Aucun colis trouvé avec ce numéro
`500`	Internal server error	Erreur serveur interne

Tester l'API

Essayez l'API directement depuis votre navigateur

Cliquez sur le bouton ci-dessous pour tester l'API avec un numéro de suivi exemple :

Support

Pour toute question ou assistance technique, contactez-nous :

Bamako : 74 52 01 57 / 64 24 24 22
Kéniéba : 73 07 18 92 / 65 55 94 54