Tous les guides

Cas d’usage et mise en œuvre

Connecter signalements, preuves et actions produit

Intégrez collecte, contexte signé, services de preuve limités et callbacks idempotents étape par étape.

Conçu pour
Ingénieurs produit, Trust & Safety, sécurité et responsables intégration
Guide actuel
Mis à jour le 29 août 2026

01

Point de départ

Votre produit reste propriétaire des utilisateurs, messages, annonces ou espaces. Safest Resolve reçoit un signalement explicite et demande uniquement le contexte du workflow publié.

02

Conditions à respecter

  • Exposer une clé serveur dans le navigateur ou accepter une référence non signée.
  • Copier des dossiers complets quand quelques champs suffisent.
  • Rejouer une action sans clé d’idempotence ou fermer avant confirmation.

03

Étape par étape

  1. Choisissez l’entrée : /widget.js, /report/ ou /v1/reports/server.
  2. Créez une intégration au moindre privilège. Gardez la clé côté serveur et émettez un jeton de contexte court pour le widget.
  3. Envoyez l’allégation structurée avec une clé d’idempotence et conservez les références retournées.
  4. Définissez chaque composant de preuve avec entrées autorisées, schéma borné, délai et version immuable. Vérifiez la signature avant de retourner le résultat typé.
  5. Créez des intégrations distinctes pour evidence_callback et action_callback.
  6. Publiez les fixtures et la révision de routage, le workflow visuel, puis épinglez sa version à la file.
  7. Testez succès, doublon, délai dépassé, reprise d’action, message, attribution humaine et appel.

04

Limite opérationnelle

Utilisez des références opaques. Un échec de preuve obligatoire bloque la décision, les actions importantes attendent une personne, les appels sont idempotents et chaque callback garde un état explicite.

05

Échange de données

Safest Resolve envoie une référence stable dans une requête signée et limitée dans le temps. Votre service renvoie seulement les champs approuvés. Les actions utilisent une connexion signée séparée et une clé stable; le callback enregistre le résultat réel.

Référence stableRequête signéeRésultat typé

06

Vérification

Le signalement rejoint une file versionnée et un workflow durable. Le dossier montre preuve, propriétaire, décision, action, résultat, messages et appel sans dupliquer votre base produit.

07

Questions de mise en œuvre

Peut-on garder notre formulaire actuel ?+

Oui. Envoyez sa sortie structurée par l’API serveur et conservez votre référence externe.

Quel identifiant peut terminer un callback ?+

Utilisez des intégrations séparées. evidence_callback et action_callback ne sont pas inclus dans submit_reports.

Safest Resolve

Modélisez le premier workflow de votre équipe.

Commencez par la source du signalement, les preuves requises, le décideur, l’action produit, les messages et la voie d’appel.