Développeurs

Déclencher un workflow depuis votre code, piloter la plateforme depuis un workflow, et créer vos propres nœuds pour la Marketplace.

Déclencher un workflow par webhook

Un workflow qui commence par un Webhook reçoit un appel HTTP de n'importe quel service. Le panneau du bloc affiche ses adresses :

URL de production : active après publication, /hooks/<workflow>/<chemin> dans l'environnement par défaut, /hooks/env/<clé>/<workflow>/<chemin> dans un autre environnement.
URL de test : cliquez sur « Écouter un appel de test » ; pendant deux minutes, un appel exécute le brouillon dans l'environnement choisi.

Exemple d'appel

curl -X POST https://app.dev.orkyvo.fr/hooks/<identifiant du workflow>/commandes \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: commande-1042" \
  -d '{ "id": 1042, "email": "marie@exemple.fr", "total": 120 }'

Les appels répétés avec la même clé Idempotency-Key ne créent qu'une exécution. Pour renvoyer une réponse calculée par le workflow, réglez « Réponse » sur l'option « Par un bloc » et terminez par Répondre au webhook. Corps limité à 1 Mo.

Piloter la plateforme depuis un workflow

Orkyvo (API de la plateforme) : lire les workflows, les exécutions et le journal d'audit, annuler une exécution, dans votre organisation.
Événements Orkyvo : démarrer un workflow quand un workflow est activé, republié ou désactivé. Pour réagir à un échec, utilisez un workflow d'erreur commençant par un Déclencheur d'erreur.
Exécuter un sous-workflow et Appelé par un workflow : découper un traitement en workflows réutilisables.

Créer un nœud

Un nœud de la Marketplace est décrit par un manifeste JSON : champs de configuration, authentification, permissions, opérations, schémas, exemples et documentation. Depuis l'application, ouvrez Développeurs › Créer un nœud : nom, identifiant unique et définitif, catégorie et mode.

Configuration guidée

Pour une intégration HTTP simple : le manifeste décrit les requêtes sous forme de gabarits ({{ $params.champ }}, {{ $credentials.cle }}) et le moteur d'Orkyvo construit les requêtes. Aucun code n'est exécuté. Authentification : aucune, clé en en-tête ou en URL, Bearer ou Basic.

Développement JavaScript

Chaque opération est une fonction exportée par src/index.js, écrite dans l'espace de codage et exécutée uniquement dans le service isolé, sans accès à la base ni au réseau interne ; les appels HTTP passent par le pont contrôlé de la plateforme.

L'espace développeur fournit la référence du manifeste, le SDK et des manifestes officiels à télécharger, une prévisualisation (carte de la Marketplace, bloc, panneau) et des tests sur données fictives, sans aucun appel réseau.

Validation et publication

Cycle d'une version : Brouillon → En validation → Modifications demandées ou Approuvé → Publié (ou Refusé). Une version publiée est immuable : une évolution passe par un nouveau numéro de version, et installer une nouvelle version ne modifie aucun workflow existant.

À savoir. Personne ne peut valider un nœud de sa propre organisation, ni une version qu'il a créée ou soumise. La validation et les tests sont relancés côté serveur avant l'approbation.