Verwenden Sie eine Messaging-Marke, die dem Konto gehört
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 Anbietertoken, Identitätsdaten der Marke und zurückgegebene Berichte vertraulich.
Verwenden Sie ein vorhandenes Ergebnis eines Anbieters
Verwenden Sie PUT, um Ihrer Marke ein vorhandenes Prüfergebnis eines unterstützten Anbieters zuzuordnen. Dadurch wird keine neue Prüfung bestellt. Beziehen Sie die korrekte Transaktions-ID des Anbieters und einen gegebenenfalls erforderlichen Bestätigungstoken direkt von diesem Anbieter und stellen Sie sicher, dass sich der Bericht auf dieselbe Unternehmensidentität bezieht.
AUTHPLUS unterstützt diesen Importablauf nicht. Anbieterspezifische Abgleichregeln gelten weiterhin; eine Importanfrage hebt sie weder auf noch garantiert sie die Zulassung für jeden Kampagnenanwendungsfall.
Bereiten Sie den Import vor
| Feld | Wert |
|---|---|
| evpId | ID eines unterstützten Anbieters, 1–10 Zeichen. |
| vettingId | Die tatsächliche Kennung der Prüftransaktion beim Anbieter, bis zu 255 Zeichen. Verwenden Sie stattdessen weder die Marken-ID noch eine erfundene Kennung. |
| vettingToken | Bestätigungstoken, sofern vom Anbieter verlangt, bis zu 65535 Zeichen. Behandeln Sie ihn als Geheimnis und lassen Sie ihn weg, wenn der Anbieter ihn nicht verlangt. |
Erstellen Sie vetting-import.json mit den tatsächlichen Werten des Anbieters. Senden Sie keine ausschließlich für Antworten vorgesehenen Felder für Bewertung, Status oder Zeitstempel in der Annahme, damit das Ergebnis ändern zu können.
Importieren Sie das Ergebnis einmal
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-import.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Berücksichtigen Sie bestehende Gebühren
Ein neu importiertes Ergebnis wird von diesem Proxy nicht als neue kostenpflichtige Bestellung erfasst. Eine zuvor bestellte Prüfung wird dadurch nicht storniert: Wenn für dieselbe vettingId bereits eine Bestellung vorliegt, die auf ein Ergebnis oder auf die Gebührenberechnung wartet, kann der Import eines Ergebnisses mit dem Status ACTIVE oder FAILED die Abrechnung der dafür gespeicherten Gebühr auslösen. Für einen bereits abgerechneten Datensatz wird in diesem Synchronisierungszweig keine weitere Gebühr berechnet.
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 bezeichnen unterschiedliche Ergebnisse. Die Annahme auf HTTP-Ebene allein belegt weder eine günstige Bewertung noch die Zulassung für Kampagnen.
Verwenden Sie den Status der externen Prüfung, um den Datensatz zu verfolgen. Das Abrufen oder Importieren eines abschließenden Ergebnisses kann die Abrechnung einer früheren kostenpflichtigen Bestellung auslösen; dabei kann also eine bereits bestehende offene Gebühr anfallen.
Wiederholen Sie dieselbe beabsichtigte Anfrage
Verwenden Sie für jeden beabsichtigten Vorgang einen Idempotency-Key und bewahren Sie Methode, Pfad, Abfrage und die Bytes des Anfrageinhalts exakt auf. Schlüssel unterstützen 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Eine doppelte Anfrage kann während der laufenden Verarbeitung 409 mit Retry-After zurückgeben. Bei abgeschlossenen Anfragen wird die gespeicherte Antwort einschließlich etwaiger Fehler erneut ausgegeben. Beachten Sie die Anfrageratenbegrenzungen.
Ein zwischengespeicherter Fehler 502 kann auf einen Übertragungsfehler folgen. Ein zwischengespeicherter Fehler 500 mit requestId kann bedeuten, dass die Registrierungsstelle den Vorgang angenommen hat, aber die lokale dauerhafte Speicherung oder die Abrechnung fehlgeschlagen ist. Bewahren Sie die Anfrage-ID auf, prüfen Sie die aktuellen Datensätze und klären Sie den Vorgang mit dem Support, bevor Sie einen neuen Schlüssel verwenden. Gehen Sie nicht davon aus, dass der Fehler bedeutet, es liege keine Bestellung vor.