Requêtes HTTP
Planfix vous permet d'envoyer des requêtes HTTP via scripts et webhooks entrants et prend en charge les méthodes suivantes :
- GET
- POST
- PUT
- DELETE
Exemples de requêtes HTTP et d'analyse des réponses
- GET-request: obtaining exchange rates
- POST-request to Stripe: payment link
- Requêtes HTTP et services postaux
- Réception de requêtes HTTP via les webhooks entrants
Important
- Les requêtes POST sont envoyées depuis votre compte en mode mono-thread. Une nouvelle requête POST n'est pas envoyée tant qu'une réponse à la requête précédente n'a pas été reçue. De ce fait, s'il y a un délai important dans la réponse du serveur distant, l'envoi des requêtes suivantes peut être fortement retardé.
- Si une réponse réussie n'est pas reçue du serveur distant (statut de réponse différent de 200), Planfix tentera de renvoyer la requête plusieurs fois, après des intervalles de temps définis. Cinq tentatives supplémentaires sont effectuées : après 5 / +15 / +30 / +60 minutes. Ceci est fait pour éviter la perte de messages si le serveur distant est temporairement indisponible ou hors service.
- De plus, aucune autre requête POST ne sera envoyée depuis votre compte pendant trois minutes après la réception d'une réponse infructueuse ou de l'absence de réponse du serveur. Il s'agit d'une mesure nécessaire pour garantir que Planfix continue de fonctionner de manière stable lorsqu'un grand nombre de requêtes est envoyé depuis un compte et que le serveur destinataire cesse de répondre.
- Les incidents d'envoi infructueux sont consignés dans le Panneau des incidents.
- Vous pouvez désactiver les nouvelles tentatives automatiques dans les paramètres des requêtes POST :
- Tous les détails du traitement des requêtes HTTP sont enregistrés dans le journal technique de la tâche :
Utilisation des variables dans les requêtes HTTP
Par défaut, toutes les variables insérées dans l'URL sont encodées en URL afin d'assurer leur transmission correcte en tant que paramètres de requête. Par exemple :
https://mysite.com/?param1={{Variable_1}}¶m2={{Variable_2}}
Si votre variable contient déjà des paramètres chiffrés ou fait partie de l'URL et ne doit pas être encodée, entourez-la par %%% :
%%%{{Infoblock.RequestURL}}%%%
https://my.site.com/%%%{{Infoblock.Parameters}}%%%
En complément
- Les données entrant dans Planfix peuvent être ensuite traitées avant d'être utilisées.