curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
Leads & Formulare
Lead-Liste in ein Formular umwandeln
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"
}
Migriert eine veraltete Lead-Liste in ein Formular — den aktuellen, empfohlenen Lead-Erfassungs-Builder von Scanova.
Das Umwandeln einer Lead-Liste:
Erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota, gesendet als roher Authorization-Header-Wert — siehe die Übersicht über die Management API.string
erforderlich
Die
lead_id der Lead-Liste. Kein Request-Body.curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
- Erstellt ein neues Formular aus den Felddefinitionen der Lead-Liste.
- Verknüpft jeden QR-Code, der aktuell an die Lead-Liste angehängt ist, stattdessen erneut mit dem neuen Formular.
- Migriert aktive Webhooks zum Webhook-Mechanismus des Formulars (die eigenen Webhooks der Lead-Liste werden als inaktiv markiert).
- Migriert alle für diese Lead-Liste konfigurierten Lead-Benachrichtigungen zu Formular-Benachrichtigungen.
- Markiert die Lead-Liste als
is_converted: true— ab diesem Zeitpunkt erscheint sie nicht mehr in Lead-Listen auflisten oder Aktive Lead-Listen auflisten, und weitere Bearbeitungen/Einträge/Exporte laufen stattdessen über die Formular-Endpunkte.
Dies ist nicht auf freundliche Weise idempotent: Ein erneuter Aufruf der Umwandlung für eine bereits umgewandelte Lead-Liste gibt
404 zurück, da die Suche auf nicht umgewandelte Listen gefiltert wird. Es gibt kein „Rückgängig machen” — prüfen Sie is_converted (über Lead-Liste abrufen, was nach der Umwandlung 404 zurückgibt), bevor Sie es erneut versuchen.400 unter data, wenn die transformierten Formulardaten unerwartet die Schemavalidierung des Formulars nicht bestehen (ein seltener Randfall durch Formabweichung, der bei einer wohlgeformten Lead-Liste normalerweise nicht auftreten sollte).
Verwandte Themen
- Lead-Listen auflisten — für die Umwandlung infrage kommende Lead-Listen.
- Formularverwaltung — wo sich die umgewandelte Ressource danach befindet.
- Übersicht über die Management API — das Authentifizierungsschema und die Quota-Architektur, zu der dieser Endpunkt gehört.
Autorisierungen
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.
Antwort
201
Converted.
War diese Seite hilfreich?