Verwenden Sie eine dem Konto zugeordnete Marke für den Nachrichtenversand
Verwenden Sie ein freigeschaltetes API-Konto über HTTPS von einer zulässigen Quell-IP-Adresse aus. Die Authentifizierung mit Basic und Bearer wird unterstützt. Die Marken-ID muss zu diesem Konto gehören. Behandeln Sie Anbieter-Tokens, Identitätsdaten der Marke und zurückgegebene Berichte vertraulich.
Bestellen Sie eine neue externe Prüfung
Verwenden Sie POST, wenn ein Prüfanbieter eine neue Prüfung dieser Marke durchführen soll. Wenn Ihnen bereits ein Anbieterergebnis vorliegt, verwenden Sie stattdessen den Import. Dieser Vorgang ist unabhängig von der erneuten Überprüfung der Markenidentität.
Lesen Sie zunächst die aktuellen Markendaten aus und bestätigen Sie die Identitätsangaben. Wählen Sie eine unterstützte Kombination aus Anbieter und Klasse aus den aktuellen Katalogen und prüfen Sie die Anforderungen dieses Anbieters. Nicht jeder Anbieter unterstützt jede Klasse. Zusätzliche Angaben für politische Prüfungen müssen die tatsächliche Organisation oder Kampagne beschreiben und dürfen keine Beispieldaten sein.
Bereiten Sie die Anfrage an den Anbieter vor
| Feld | Wert |
|---|---|
| evpId | Erforderliche Anbieter-ID aus dem aktuellen Katalog der Anbieter externer Prüfungen, 1–10 Zeichen. |
| vettingClass | Die unterstützte Klasse, die Sie kaufen möchten; wählen Sie diese ausdrücklich aus und bestätigen Sie ihren Preis. |
| additionalRequestPayload | Eine JSON-kodierte Zeichenfolge mit anbieterspezifischen Angaben, die für politische Prüfungen erforderlich ist. Es handelt sich um eine Zeichenfolge innerhalb des äußeren JSON-Objekts, nicht um ein verschachteltes Objekt. Klären Sie alle erforderlichen Angaben mit dem ausgewählten Anbieter ab. |
Bestätigen Sie die Gebühren bei Erfolg und Fehlschlag
Aktuelle Endkundenpreise in US-Dollar, abgelesen am 24. Oktober 2026. Bestätigen Sie den aktuellen Betrag, bevor Sie eine echte Bestellung aufgeben. Das vorausbezahlte Guthaben wird anhand des Preises für einen erfolgreichen Ausgang geprüft; Käufe müssen freigeschaltet sein.
| Klasse | Aktives Ergebnis | Fehlgeschlagenes Ergebnis |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL mit Express-Anfrage | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Bei ausstehenden Bestellungen bleiben die Beträge für Erfolg und Fehlschlag gespeichert; die Abrechnung erfolgt, sobald ein Ergebnis mit ACTIVE oder FAILED synchronisiert wird. Für die letzten beiden Klassen gilt bei beiden endgültigen Ergebnissen dieselbe konfigurierte Gebühr. Bei einem sofortigen endgültigen Ergebnis kann die Gebühr bereits während der Antwort auf die Bestellung berechnet werden. Eine spätere Statussynchronisierung kann eine ausstehende Gebühr abrechnen.
Betrachten Sie mock:true nicht als Zusicherung einer kostenlosen externen Prüfung. Der aktuelle Abrechnungsablauf für externe Prüfungen kann diese Bestellung dennoch erfassen und berechnen. Diese Anleitung erfordert keinen echten Kauf zu Testzwecken; verwenden Sie Offline-Testdaten, bis Sie eine kostenpflichtige Prüfung autorisieren möchten.
Senden Sie eine einzelne, zuvor geprüfte Bestellung ab
Bereiten Sie vetting-order.json mit der Anbieter-ID, der Klasse und allen erforderlichen zusätzlichen Angaben vor. Die Datei enthält die tatsächlich beabsichtigte Anfrage. Behandeln Sie sie vertraulich.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Verfolgen Sie das tatsächliche Ergebnis
Eine erfolgreiche HTTP-Antwort kann einen noch ausstehenden Prüfdatensatz enthalten. Bewahren Sie dessen vettingId auf und prüfen Sie vettingStatus, Begründungen, Bewertung sowie Gültigkeitsbeginn und Ablaufdatum, soweit verfügbar. PENDING und UNSCORE erfordern weitere Nachverfolgung; ACTIVE, FAILED und EXPIRED beschreiben unterschiedliche Ergebnisse. Die Annahme auf HTTP-Ebene allein belegt weder eine günstige Bewertung noch die Zulässigkeit einer Kampagne.
Verwenden Sie den Status der externen Prüfung, um den Datensatz zu verfolgen. Das Abrufen oder Importieren eines endgültigen Ergebnisses kann eine frühere kostenpflichtige Bestellung abrechnen; dabei kann eine bereits ausstehende Gebühr anfallen.
Wiederholen Sie dieselbe beabsichtigte Anfrage
Verwenden Sie pro beabsichtigtem Vorgang einen Idempotency-Key und bewahren Sie Methode, Pfad, Abfrage und die Bytes des Anfragetexts exakt auf. Schlüssel unterstützen 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Ein Duplikat eines noch laufenden Vorgangs kann 409 mit Retry-After zurückgeben. Bei abgeschlossenen Anfragen wird die gespeicherte Antwort erneut ausgegeben, einschließlich etwaiger Fehler. Beachten Sie die Ratenbegrenzungen.
Auf einen Übertragungsfehler kann eine zwischengespeicherte 502-Antwort folgen. Eine zwischengespeicherte 500-Antwort mit requestId kann bedeuten, dass die Registrierungsstelle den Vorgang angenommen hat, die lokale Speicherung oder Abrechnung jedoch fehlgeschlagen ist. Bewahren Sie die Anfrage-ID auf, prüfen Sie die aktuellen Datensätze und klären Sie den Vorgang mit dem Support ab, bevor Sie einen neuen Schlüssel verwenden. Gehen Sie nicht davon aus, dass der Fehler bedeutet, dass keine Bestellung existiert.