Comment annoncer des tâches par API ?

Aperçu

1. Requis
2. Annoncer par API

1. Requis

1. Consultez notre documentation API détaillée : https://docs.urbantz.com/
2. Téléchargez et installez une plateforme API de votre choix. Nous recommandons Postman.
3. Vous aurez besoin des informations suivantes :
   • La clé API de votre plateforme Urbantz. Trouvez-la dans Administration > Plateforme > Général
     
   • La clé API secrète de votre flux. Trouvez-la dans Administration > Flux > Intégration > Announcement, et cliquez le Plus (en mode avancé).

2. Annoncer par API

1. Ouvrez Postman ou une autre plateforme API et sélectionnez la méthode POST
2. Insérez cette URL: https://api.urbantz.com/v2/task/
3. Insérez les en-têtes suivants :
   • Type de contenu : application/json
   • x-api-key :[clé API de la plateforme]
   • x-api-secret :[clé API du flux]
     Vous pouvez également utiliser Basic Auth pour insérer les identifiants.
4. Insérez le payload de votre requête
5. Cliquez sur envoyer. 

Urbantz retournera un code de statut, un timestamp et un identifiant d'annonce et une ligne d'annonce sera créée sur la page d'annonce de votre plateforme.

Remarque : veuillez noter que le champ « contact.name » dans le body de l’API correspond à la colonne 

« Client company » dans la vue des tâches, tandis que le destinataire final est reflété dans le champ            

« contact.person ».

Ainsi, par exemple, pour le destinataire « John Smith » propriétaire de la société « Smith and Sons », les champs seront renseignés comme suit :

contact.name : "Smith and Sons"

contact.person : " John Smith "