Documentation API

API CasaTawsil
pour développeurs

Intégrez nos services de livraison au Maroc dans votre boutique en ligne via notre API REST simple, rapide et sécurisée.

response.json — casatawsil.com
// GET /api/track.php?code=CT-20241215
[
{
"Etat": "Livré",
"Date_Evenement": 1710423600
},
{
"Etat": "En cours de livraison",
"Date_Evenement": 1710337200
},
{
"Etat": "Expédié",
"Date_Evenement": 1710252000
}
]
Tracking Colis
Suivez l'état d'un colis en temps réel
GET
Endpoint
GET
https://casatawsil.com/api/track.php?code=CODE_COLIS
Paramètres
ParamètreRequisDescription
code Obligatoire Code de suivi du colis
Réponse JSON
JSON
[
  {
    "Etat": "Expédié",
    "Date_Evenement": 1610824063
  },
  {
    "Etat": "Prêt pour expédition",
    "Date_Evenement": 1610819137
  },
  {
    "Etat": "Nouveau",
    "Date_Evenement": 1610816442
  }
]
Réponses
200 — Succès Tableau JSON des événements de suivi
Parameters code is missing Le paramètre code est absent de la requête
Parameters code is empty Le paramètre code est vide
Code doesn't exist Aucun colis trouvé pour ce code
Ajout Colis
Créez un nouveau colis depuis votre boutique
GET
Endpoint
GET
https://casatawsil.com/api/addcolis.php?tk=TOKEN&sk=SECRET_KEY&fullname=NOM&phone=TEL&city=VILLE&address=ADRESSE&price=PRIX&product=PRODUIT&qty=QTE¬e=NOTE&change=0&openpackage=1
Paramètres
ParamètreRequisDescription
tkObligatoireToken — voir Mon Profil
skObligatoireClé secrète — voir Mon Profil
fullnameObligatoireNom complet du destinataire
phoneObligatoireNuméro de téléphone
cityObligatoireVille (voir endpoint Villes)
addressObligatoireAdresse complète
priceObligatoireContre-remboursement en MAD
productObligatoireProduit(s) séparés par virgule
qtyObligatoireQuantité(s) séparées par virgule
noteOptionnelNote interne
changeOptionnel0 = Non  /  1 = Échange
openpackageOptionnel0 = Non  /  1 = Ouverture autorisée
Réponses
Package added successfully Le colis a été créé avec succès
Some parameters are missing Un ou plusieurs paramètres obligatoires sont absents
Some parameters are empty Les paramètres ne doivent pas être vides
This account doesn't exist or it is disabled Compte inexistant ou désactivé
Liste des Colis
Récupérez l'ensemble de vos colis
GET
Endpoint
GET
https://casatawsil.com/api/colislist.php?tk=TOKEN&sk=SECRET_KEY
Paramètres
ParamètreRequisDescription
tkObligatoireToken — voir Mon Profil
skObligatoireClé secrète — voir Mon Profil
Réponses
List of packages Tableau JSON de tous vos colis avec leurs états
Some parameters are missing Token ou clé secrète manquant(e)
This account doesn't exist or it is disabled Compte inexistant ou désactivé
Liste des Villes
Villes desservies et frais de livraison
GET
Endpoint
GET
https://casatawsil.com/api/cities.php
Cet endpoint est public — aucune authentification requise.
Paramètres
ParamètreRequisDescription
Aucun paramètre requis
Réponses
List of cities and fees Tableau JSON des villes avec leurs frais de livraison
Modification État Colis
Mise à jour de l'état — réservé aux livreurs
GET
Endpoint
GET
https://casatawsil.com/api/editstate.php?tk=TOKEN&sk=SECRET_KEY&code=CODE_COLIS&state=ETAT&datereported=DD/MM/YYYY&phone=PHONE_LIVREUR¬e=NOTE
Paramètres
ParamètreRequisDescription
tkObligatoireToken — voir Mon Profil
skObligatoireClé secrète — voir Mon Profil
codeObligatoireCode de suivi du colis
stateObligatoireNouvel état à appliquer
datereportedObligatoireDate au format DD/MM/YYYY
phoneObligatoireNuméro de téléphone du livreur
noteOptionnelCommentaire additionnel
Réponses
Package updated successfully L'état du colis a été mis à jour
Some parameters are missing Un ou plusieurs paramètres obligatoires manquants
This package doesn't belong to this account Vous n'êtes pas autorisé à modifier ce colis