Détecter, remplacer et restaurer les données personnelles
Utilisez les API de texte natives pour la détection et un remplacement réversible et cohérent.
Détecter les données personnelles
POST /v1/analyze accepte un champ text ou un tableau texts . Les positions natives comptent les points de code Unicode à partir de zéro ; endIndex est exclusif.
| Paramètre | Signification |
|---|---|
text / texts | Une chaîne ou un tableau de chaînes. Envoyez un seul de ces champs. |
tier | standard, batch ou realtime |
model | shinrai-latest ou shinrai-v1.3. Les alias de niveau peuvent ajouter -batch ou -realtime. |
threshold | Seuil de confiance de 0 à 1 ; valeur par défaut : 0,7. |
merge_persons | Fusionner les détections de personnes adjacentes ; true par défaut. |
GET /v1/models liste les modèles et niveaux API accessibles à votre clé. OpenAPI est la référence native lisible par machine.
Qu’est-ce que le chiffrement sémantique ?
ShinrAI appelle chiffrement sémantique son remplacement réversible qui préserve le contexte. Cette pseudonymisation remplace les valeurs sensibles par des alternatives utiles ; votre application peut restaurer les originaux grâce à sa correspondance.
Protégez la correspondance comme une donnée sensible et excluez-la des prompts. Des remplacements réalistes ne signifient pas que chaque mot est chiffré cryptographiquement ni que le texte est automatiquement anonyme.
Langues et catégories de données · Historique des modèles · Comparer ShinrAI
Remplacer les données personnelles et conserver la correspondance
POST /v1/redact renvoie le texte transformé. Choisissez replace pour des valeurs de substitution réalistes et cohérentes, mask pour masquer les caractères, ou label pour des étiquettes d’entités telles que [PERSON].
curl https://api.shinrai.innovius.io/v1/redact \
-H "Authorization: Bearer $SHINRAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Contact Emma at emma@example.com","mode":"replace"}'
Exemple de réponse (simulé)
Extrait JSON simulé pour la commande ci-dessus. Les détections, les valeurs de remplacement et votre solde peuvent différer.
{
"mode": "replace",
"tier": "standard",
"text": "Contact Nora at nora@example.net",
"mapping": {
"Emma": "Nora",
"emma@example.com": "nora@example.net"
},
"usage": {
"records": 1,
"weighted_records": 1.0,
"tier": "standard",
"balance_after": 9998.0
}
}Conservez la mapping retournée en sécurité dans votre application si vous devez restaurer le texte. Envoyez known_replacements pour réutiliser les valeurs de substitution entre appels ; reserved_replacements exclut les valeurs à ne pas générer. mask_char contrôle le masquage et utilise par défaut *.
Vérifiez les détections sur des documents représentatifs. Les textes pseudonymisés et les correspondances de restauration peuvent rester sensibles ; la transformation ne garantit pas l’anonymisation.
Conserver des remplacements cohérents dans un lot
Utilisez POST /v1/redact/batch lorsque plusieurs enregistrements appartiennent au même flux. ShinrAI conserve une seule table de remplacement pour la requête et peut réutiliser les correspondances fournies dans known_replacements.
{"texts":["Emma owns the case.","Email Emma at emma@example.com"],"mode":"replace","include_mapping":true}
Les correspondances renvoyées contiennent les valeurs d’origine. Stockez-les comme données applicatives sensibles et excluez-les des invites du modèle.