curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
Prospects et formulaires
Convertir une liste de leads en Formulaire
POST /lead//convert/
POST
/
lead
/
{lead_id}
/
convert
/
curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
Migre une liste de leads héritée vers un Formulaire — le générateur de capture de leads actuel et recommandé de Scanova.
Convertir une liste de leads :
Nécessite une clé d’API de gestion avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX), envoyée comme valeur brute de l’en-tête Authorization — voir la présentation de l’API de gestion.string
requis
Le
lead_id de la liste de leads. Pas de corps de requête.curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
- Crée un nouveau Formulaire à partir des définitions de champs de la liste de leads.
- Relie chaque code QR actuellement rattaché à la liste de leads au nouveau Formulaire à la place.
- Migre les webhooks actifs vers le mécanisme de webhooks du Formulaire (les propres webhooks de la liste de leads sont marqués inactifs).
- Migre toute notification de leads configurée pour cette liste de leads vers des notifications de Formulaire.
- Marque la liste de leads
is_converted: true— à partir de ce moment, elle n’apparaît plus dans Lister les listes de leads ni dans Lister les listes de leads actives, et les modifications/entrées/exports ultérieurs passent désormais par les endpoints Formulaires.
Cette opération n’est pas idempotente de façon amicale : appeler la conversion une deuxième fois sur une liste de leads déjà convertie renvoie
404, car la recherche filtre sur les listes non converties. Il n’y a pas d’« annulation » — vérifiez is_converted (via Récupérer une liste de leads, qui renverra 404 une fois convertie) avant de réessayer.400 sous data si les données de formulaire transformées échouent de manière inattendue à la validation du schéma de Formulaire (un cas limite rare de dérive de forme, qu’une liste de leads bien formée ne devrait normalement pas déclencher).
Voir aussi
- Lister les listes de leads — les listes de leads éligibles à la conversion.
- Gestion des formulaires — où réside la ressource convertie par la suite.
- Présentation de l’API de gestion — le schéma d’authentification et l’architecture de quotas dont fait partie cet endpoint.
Autorisations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Réponse
201
Converted.
Cette page vous a-t-elle été utile ?