Vos Identifiants API

Voici votre Token Bearer actuel ainsi que votre ID Client (customers_id).

---

Informations utiles :

• Utilisation : Ajoutez le token Bearer dans l’en-tête de vos requêtes API sous la forme : Authorization: Bearer <votre_token>
• Expiration : Les tokens ne périment pas automatiquement, mais vous pouvez en générer un nouveau si besoin.
• Sécurité : Ne partagez jamais votre token publiquement. Conservez-le en sécurité.

Documentation API

Voici comment vous pouvez interagir avec notre API pour ajouter des colis.

1. Ajouter des colis

Pour ajouter un colis, vous devez faire une requête POST à l'URL suivante :
https://client-api.elog.ma/addparcelsnew

2. En-têtes Requis dans HEADER

Les en-têtes suivants doivent être envoyés avec votre requête :

• Authorization: Bearer [Votre_token]
• customers_id: [ID Client] (le client ID indiqué pour l'utilisateur)

Note: Le token d'autorisation doit être dans le format Bearer [Token].

3. Corps de la Requête (Payload)

Le corps de la requête doit contenir les informations suivantes sous forme de JSON :

{
  "parcel_code": "codspottestcantryy", // Remplacer parVariable du code de suivi
  "parcel_receiver": "radouane", // Nom du client final qui reçoit le colis
  "parcel_phone": "0672913111", // ici Variable de la ville
  "parcel_customer": "735",  // ID du client indiqué dans votre espace client chez Power Delivery
  "parcel_city": "4247", // Exemple d'ID d'une ville
  "parcel_price": 0, // Prix du colis
  "parcel_address": "Marrakech Mhamid",
  "parcel_try": 1  // 0 si le produit est essayable, 1 s'il n'est pas essayable
}
               

4. Réponses

Voici les réponses possibles que vous recevrez de l'API :

• Succès :

  {"success": "Colis Ajouté Avec Succès"}

• Erreur de Token :

  {"error": "Le token n'est pas valide"}

• Client Non Autorisé :

  {"error": "Ce Client pas autorisé - verifier qu'il est activé par administrateur"}

5. Codes d'Erreurs

Voici quelques erreurs courantes et leurs significations :

• 401 Unauthorized : Cela signifie que votre token d'autorisation est invalide ou expiré.
• 403 Forbidden : Le client ID que vous utilisez n'est pas autorisé à accéder à cette API.

6. Sécurité

Ne partagez jamais vos tokens API publiquement et conservez-les dans un endroit sécurisé.

7. Remarque Importante

parcel_customer : Ce champ doit correspondre à l'ID du client indiqué dans la requête. Assurez-vous que l'ID client est valide et autorisé pour utiliser l'API.

parcel_try : Utilisez 0 si le produit est essayable, et 1 si le produit ne peut pas être essayé.

Exemple de data envoyée avec succès :

---

2. Récupérer la liste des villes

Vous pouvez récupérer la liste complète des villes disponibles dans notre base de données à utiliser dans vos colis.

Endpoint :

Faites une requête GET vers :
https://client-api.elog.ma/listcities

En-têtes requis :

• Authorization: Bearer [Votre_token]
• customers_id: [ID Client]

Exemple de réponse :

[
  {
    "city_id": "4247",
    "city_name": "Casablanca"
  },
  {
    "city_id": "4248",
    "city_name": "Marrakech"
  },
  ...
]

Utilisez les city_id retournés comme valeur pour le champ parcel_city lorsque vous créez un colis.