API RiskSonnar

L’API REST permet de lancer une analyse et de lire son état, son indice de vigilance puis ses résultats. Chaque utilisateur emploie sa propre clé. La décision reste à votre équipe.

Authentification

Chaque requête porte une clé API propre à l’utilisateur dans l’en-tête Authorization: Bearer. Conservez-la hors du code source et ne la partagez pas entre utilisateurs.

Lancer une analyse

# Analyse complète — délai variable selon les sources
curl -X POST https://www.risksonnar.com/api/v1/scan \
  -H "Authorization: Bearer VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"company_name": "Entreprise Exemple SAS (fictive)", "country": "FR"}'

# Réponse minimale illustrée
{
  "analysis_id": "identifiant-de-l-analyse"
}

Lire une analyse

curl https://www.risksonnar.com/api/v1/analysis/{analysis_id} \
  -H "Authorization: Bearer VOTRE_CLE"

La réponse expose les éléments disponibles, leurs limites et un avis. La décision reste humaine.

Webhooks

Webhooks : pas encore disponibles dans cette version. Les scénarios décrits sur la page Intégrations restent des aperçus et ne constituent pas des connecteurs livrés.

Analyses en lot

L’API JSON accepte jusqu’à 20 entités par appel :

curl -X POST https://www.risksonnar.com/api/v1/scan-batch \
  -H "Authorization: Bearer VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"names": [{"company_name": "Entreprise Exemple SAS (fictive)", "country": "FR"}]}'

Chaque élément du lot devient une analyse à relire séparément. Chaque avis doit être examiné ; la décision reste humaine.

Limites & bonnes pratiques

La durée d’une analyse varie selon l’entité et les sources disponibles ; prévoyez une lecture espacée de son état.
Une analyse récente peut être servie depuis le cache ; ne fondez pas votre intégration sur un délai fixe.
Traitez explicitement les états partiels ou indisponibles et laissez la conclusion à une personne.

Créer un compte