RessourcenVerifizierungen

Verifizierungen

Erstellen, verwalten und übermitteln Sie regulatorische Compliance-Anmeldungen für Telefonnummern über die Talkturo API — verwalten Sie Twilio Regulatory Bundle-Erstellung, Dokument-Uploads und Live-Verifizierungsstatus.

curl -X POST "https://app.talkturo.com/api/verifications/filings" \
  -H "Content-Type: application/json" \
  -H "Cookie: sb-access-token=example_session_token" \
  -d '{
    "account": "acme-sales",
    "carrier": "twilio",
    "country": "DE",
    "numberType": "local"
  }'

{
  "success": true,
  "bundleSid": "BU1234567890abcdef1234567890abcd",
  "resumed": false
}

curl "https://app.talkturo.com/api/verifications/filings/BU1234567890abcdef1234567890abcd" \
  -H "Cookie: sb-access-token=example_session_token"

curl -X PUT "https://app.talkturo.com/api/verifications/filings/BU1234567890abcdef1234567890abcd" \
  -H "Content-Type: application/json" \
  -H "Cookie: sb-access-token=example_session_token" \
  -d '{
    "account": "acme-sales",
    "carrier": "twilio",
    "country": "DE",
    "numberType": "local"
  }'

curl -X POST "https://app.talkturo.com/api/verifications/filings/BU1234567890abcdef1234567890abcd/submit" \
  -H "Cookie: sb-access-token=example_session_token"

curl "https://app.talkturo.com/api/verifications/filings/BU1234567890abcdef1234567890abcd/documents" \
  -H "Cookie: sb-access-token=example_session_token"

curl -X POST "https://app.talkturo.com/api/verifications/filings/BU1234567890abcdef1234567890abcd/documents" \
  -H "Cookie: sb-access-token=example_session_token" \
  -F "file=@handelsregisterauszug.pdf"

curl "https://app.talkturo.com/api/verifications/live" \
  -H "Cookie: sb-access-token=example_session_token"

Verifizierungsanmeldungen über die API verwalten

Mit den Verifizierungsendpunkten erstellen, aktualisieren und übermitteln Sie regulatorische Anmeldungen für Telefonnummern. Die API unterstützt den vollständigen Ablauf von der Erstellung eines Twilio Regulatory Bundles über Dokument-Uploads bis zur Prüfung des aktuellen Live-Status.

Basis-URL: https://app.talkturo.com
Authentifizierung: Session-Cookie über enhanceRouteHandler mit auth

POST /api/verifications/filings

Erstellen Sie eine neue regulatorische Anmeldung oder setzen Sie eine bestehende Anmeldung fort.

Anfrageparameter

body
accountstring
Required

Workspace-Slug der Anmeldung.

body
carrierstring

Optionaler Carrier für die Anmeldung.

body
countrystring
Required

Zweistelliger ISO-Ländercode.

body
numberTypestring

Typ der Telefonnummer. Der Standardwert ist local.

Allowed values:localtoll-freemobilenational
body
resubmitOfstring

Optionale Twilio Bundle-SID einer bestehenden Anmeldung, die erneut eingereicht werden soll.

Antwortfelder

successboolean
Required

Gibt an, ob die Anmeldung erfolgreich erstellt oder fortgesetzt wurde.

bundleSidstring
Required

Twilio Bundle-SID der erstellten oder fortgesetzten Anmeldung.

resumedboolean
Required

true, wenn eine bestehende Anmeldung fortgesetzt wurde, andernfalls false.

GET /api/verifications/filings/{bundleSid}

Rufen Sie die Details einer bestehenden Verifizierungsanmeldung über ihre Bundle-SID ab.

Pfadparameter

path
bundleSidstring
Required

Twilio Bundle-SID der Verifizierungsanmeldung.

PUT /api/verifications/filings/{bundleSid}

Aktualisieren Sie eine bestehende Verifizierungsanmeldung über ihre Bundle-SID.

Pfadparameter

path
bundleSidstring
Required

Twilio Bundle-SID der Verifizierungsanmeldung, die Sie aktualisieren möchten.

Die verfügbaren Felder für Aktualisierungen entsprechen dem Anfrageschema der Erstellung, sofern Ihre Anmeldung zusätzliche oder geänderte Angaben erfordert.

POST /api/verifications/filings/{bundleSid}/submit

Übermitteln Sie eine fertige Anmeldung zur regulatorischen Prüfung.

Pfadparameter

path
bundleSidstring
Required

Twilio Bundle-SID der Anmeldung, die Sie zur Prüfung übermitteln möchten.

GET /api/verifications/filings/{bundleSid}/documents

Listen Sie die Dokumente auf, die einer Verifizierungsanmeldung zugeordnet sind.

Pfadparameter

path
bundleSidstring
Required

Twilio Bundle-SID der Anmeldung, deren Dokumente Sie abrufen möchten.

POST /api/verifications/filings/{bundleSid}/documents

Laden Sie ein Dokument für eine bestehende Verifizierungsanmeldung hoch.

Pfadparameter

path
bundleSidstring
Required

Twilio Bundle-SID der Anmeldung, zu der Sie ein Dokument hochladen möchten.

Wenn ein Dokument-Upload erfolgreich ist, ist das Dokument anschließend über denselben Dokumentenendpunkt abrufbar. Verwenden Sie diesen Endpunkt, um zu prüfen, ob alle erforderlichen Nachweise an die Anmeldung angehängt wurden.

GET /api/verifications/live

Rufen Sie den Live-Status von Verifizierungen ab.

Der Live-Endpunkt hilft Ihnen dabei, den aktuellen Status bereits laufender regulatorischer Verifizierungen zu prüfen, ohne einzelne Anmeldungen manuell zu öffnen.

Typischer Ablauf

So verbinden sich die Endpunkte in einem vollständigen Verifizierungsprozess.

Anmeldung erstellen oder fortsetzen

Senden Sie eine Anfrage an POST /api/verifications/filings, um ein neues Bundle anzulegen oder eine bestehende Anmeldung fortzusetzen.

Ein erfolgreicher Aufruf gibt eine bundleSid zurück. Verwenden Sie diese SID in allen nachfolgenden Endpunkten.

Anmeldungsdetails prüfen und ergänzen

Rufen Sie die Anmeldung über GET /api/verifications/filings/{bundleSid} ab und aktualisieren Sie sie bei Bedarf mit PUT /api/verifications/filings/{bundleSid}.

Wenn zusätzliche Angaben für Land, Nummerntyp oder Carrier erforderlich sind, pflegen Sie diese vor der Übermittlung ein.

Dokumente hochladen

Laden Sie alle erforderlichen Nachweise über POST /api/verifications/filings/{bundleSid}/documents hoch.

Prüfen Sie danach mit GET /api/verifications/filings/{bundleSid}/documents, ob die Dokumente der Anmeldung korrekt zugeordnet wurden.

Anmeldung zur Prüfung übermitteln

Senden Sie die fertige Anmeldung an POST /api/verifications/filings/{bundleSid}/submit.

Nach erfolgreicher Übermittlung können Sie den weiteren Fortschritt über den Live-Status-Endpunkt verfolgen.

Live-Status überwachen

Fragen Sie GET /api/verifications/live ab, um den aktuellen Verifizierungsstatus zu überwachen.

Dieser Schritt ist besonders nützlich, wenn Sie mehrere regulatorische Anmeldungen parallel verwalten.

Verwandte Ressourcen

Telefonnummern

Telefonie

Was this page helpful?