Export API
Envoie le flux d'entrée vers une API REST, en requêtes individuelles (une requête par ligne) ou par lot (batch). Utile pour pousser des enregistrements vers un CRM, un webhook ou tout service HTTP.
Connexion et authentification
Comme la brick REST API, elle
utilise de préférence une connexion REST API du projet (connection_id) ;
à défaut, base_url et authentification se saisissent sur la brick :
| Paramètre | Description |
|---|---|
auth_type | none (défaut), clé API, token Bearer ou Basic. |
api_key, api_key_location, api_key_name | Clé API en header (défaut X-API-Key) ou en query string. |
bearer_token | Token Bearer. |
basic_username, basic_password | Identifiants Basic. |
timeout | Timeout par requête (30 s par défaut). |
verify_ssl | Vérification du certificat TLS (activée par défaut). |
Requête
| Paramètre | Défaut | Description |
|---|---|---|
endpoint | / | Chemin de l'endpoint. Supporte les valeurs dynamiques par ligne : /users/{{id}} injecte la colonne id. |
http_method | POST | POST (créer), PUT (remplacer), PATCH (mettre à jour), DELETE (supprimer). |
request_mode | individual | individual : une requête par ligne ; batch : toutes les lignes d'un lot dans une requête. |
batch_size | 100 | Nombre de lignes par requête en mode batch. |
request_headers | — | Headers HTTP additionnels. |
Construction du corps
| Paramètre | Description |
|---|---|
body_template | Template Jinja2 du corps : {{ row.nom_colonne }} injecte la valeur de la ligne. Vide = la ligne (ou le lot) est envoyée telle quelle en JSON. |
data_wrapper | Clé enveloppant les données (ex. items produit un objet avec la clé items contenant le tableau). Vide = pas de wrapper. |
include_columns | Colonnes à inclure (vide = toutes). |
exclude_columns | Colonnes à exclure. |
Exemple de template en mode individuel :
{
"name": "{{ row.nom }}",
"email": "{{ row.email }}",
"source": "fluhoms"
}
Gestion des erreurs et débit
| Paramètre | Défaut | Description |
|---|---|---|
success_status_codes | 200, 201, 202, 204 | Codes HTTP considérés comme succès. |
error_handling | stop | stop : arrêter à la première erreur ; continue : continuer malgré les erreurs ; retry : réessayer puis continuer. |
max_retries | 3 | Nombre de tentatives par requête (mode retry). |
retry_delay | 1.0 | Délai entre tentatives, en secondes. |
parallel_requests | 1 | Requêtes parallèles (mode individuel, 1 à 20). |
rate_limit | 0 | Requêtes par seconde maximum (0 = illimité). |
Sorties par statut HTTP
La brick expose des sorties dynamiques routées par code de statut, comme la brick REST API :
status_outputs: règles nom de sortie / motif, où le motif est un code exact (200), un wildcard (2xx) oudefault;status_default_enabled: conserve la sortieoutpar défaut ;swagger_url: spec OpenAPI pour auto-détecter les sorties à partir des codes documentés.
tip
En mode individuel, routez les lignes refusées (4xx) vers une
Écriture fichier pour rejouer les
échecs plus tard.