API SAYINAGROUP

Suivi en direct des colis & intégrations logistiques
Documentation & outils développeur

API SAYINAGROUP — Suivi en direct des colis

Accédez aux endpoints publics et privés pour gérer les sociétés, conducteurs, expéditions et recevoir des informations de suivi en temps réel.

Voir les endpoints Essayer un endpoint

Sayina Group API

Bienvenue sur l'API du groupe Sayina. Cette page liste les endpoints disponibles (scannés depuis le dossier /api) et fournit des exemples d'appel.

Base URL

Si vous publiez l'API sur api.sayinagroup.com, la base URL sera :

https://www.api.sayinagroup.com/
Authentification

Certains endpoints nécessitent une authentification (JWT / API key). Exemple d'entête :

Authorization: Bearer <your_jwt_token>

Endpoints disponibles

Le dossier /api est introuvable sur le serveur (). Copiez d'abord les fichiers ou utilisez api_sayina/copy_api.php.

Comment utiliser cette API

Voici quelques bonnes pratiques et exemples rapides pour consommer les endpoints listés ci-dessus :

  • Base URL : utilisez la valeur affichée dans le bloc « Base URL » ci‑dessus.
  • Headers : envoyez Accept: application/json et, pour les endpoints protégés, Authorization: Bearer <token>.
  • Méthodes : respectez GET pour lectures et POST pour création/updates où spécifié.
  • Contenu : pour envoi de formulaires simples, utilisez multipart/form-data (curl -F). Pour envoi JSON, utilisez Content-Type: application/json et un body JSON.
  • Pagination : de nombreux endpoints renvoient des pages ; recherchez les paramètres page et per_page.
  • Codes d'erreur : 200 = OK, 400 = requête invalide, 401 = non autorisé, 404 = non trouvé, 500 = erreur serveur. Vérifiez le champ message ou error dans la réponse JSON pour des détails.
Exemples

curl (GET) :

curl -X GET "https://www.api.sayinagroup.com/api/companies_list.php?page=1&per_page=20" -H 'Accept: application/json'

curl (POST) :

curl -X POST "https://www.api.sayinagroup.com/api/auth_login.php" -F 'email=user@example.com' -F 'password=secret' -H 'Accept: application/json'

Fetch (JS) :

fetch('https://www.api.sayinagroup.com/api/companies_list.php')
  .then(r => r.json())
  .then(json => console.log(json));

PHP (curl) :

 = curl_init();
curl_setopt(, CURLOPT_URL, 'https://www.api.sayinagroup.com/api/companies_list.php?page=1');
curl_setopt(, CURLOPT_RETURNTRANSFER, true);
 = curl_exec();
curl_close();
 = json_decode(, true);
Remarques
  • Le scanner lit les fichiers du dossier /api et tente d'extraire une description depuis le commentaire en tête de fichier.
  • Les méthodes HTTP sont détectées heuristiquement (présence de $_POST ou $_GET dans le code).
  • Si vous utilisez des routes front-controller ou un framework, adaptez l'index pour refléter vos routes.
  • Pour publier l'API sur api.sayinagroup.com, pointez votre virtualhost vers /api_sayina ou mettez les fichiers d'API à la racine du vhost.
  • Important: supprimez api_sayina/copy_api.php avant de mettre en production ou protégez-le via authentification, car il facilite la copie de fichiers côté serveur.

Exemples détaillés

Voici des exemples détaillés pour certains endpoints courants si présents dans votre dossier /api.

Détails par endpoint

Cette section fournit, pour chaque fichier d'endpoint présent dans /api, une synthèse professionnelle : méthodes HTTP détectées, paramètres heuristiques et indication si une authentification est requise. Ces informations sont extraites automatiquement et doivent être considérées comme indicatives — vérifiez la logique métier dans le code source correspondant.

Try it — Tester rapidement un endpoint