Redact API

The Redact API helps organisations meet their privacy compliance obligations. It provides controlled, on-demand redaction of private information from transactional records in the long-term storage. Note, Redact API does not have the capability to redact the short-lived server logs that are retained for a few weeks. For SMS customers that need immediate redaction, Vonage suggests using Advanced Auto-redact.

Télécharger la spécification OpenAPI
Opérations disponibles

Redact a specific message

posthttps://api.nexmo.com/v1/redact/transaction

Authentification

CléDescriptionExemple
Authorization

Clé et secret de l'API encodés en Base64 et reliés par deux points.
En savoir plus

Headers

Basic <base64>

Corps de la demande
Type de contenu
application/json

id
string
Exigée
exemple209ab3c7536542b91e8b5aef032f6861

The transaction ID to redact

product
string
Exigée
exemplesms

Product name that the ID provided relates to

Il doit s'agir de l'un d'entre eux :smsvoicenumber-insightverifyverify-sdkmessages
type
string
Exigée
Défautoutbound
exempleoutbound

Required if redacting SMS data

Il doit s'agir de l'un d'entre eux :inboundoutbound

Exemple Demande

{
   "id": "209ab3c7536542b91e8b5aef032f6861",
   "product": "sms",
   "type": "outbound"
}

Réponses

Success

Erreurs

Voici une liste non exhaustive des codes d'erreur susceptibles de se produire lors de l'utilisation de cette API.

Ces codes s'ajoutent à ceux de notre site codes d'erreur génériques.

CodeInformations
invalid-product

Description

The provided product is invalid

Résolution

Modify your request to provide a valid product

premature-redaction

Description

There is a 1 hour time period before data can be redacted to allow for all data to propagate through the Vonage system

Résolution

Wait until the data becomes valid for redaction

rate-limit

Description

The request was rate limited

Résolution

The Redact API supports 170 requests per second. Slow down your request rate