Aller au contenu

Galaxie Artibox

Données personnelles · Référence de l'API

Exporter et effacer les données d'un invité (RGPD).

Exporter les données d'un invité (RGPD)

GET/privacy/guest

Portée : donnees:effacer Exporter et effacer les données personnelles d'un invité (RGPD)

Tout ce que l'organisation garde sur une adresse : rendez-vous, sondages, votes, envois du lien, désabonnements, réponses d'orientation. Propriétaire (`privacy.manage`). Jeton : portée `donnees:effacer`.

Paramètres

NomOùTypeObligatoireDescription
emailrequêtestring (email)oui
Exemple de requête
curl -X GET 'https://www.artibox-calendar.com/api/v1/privacy/guest' \
  -H "x-api-key: $RDV_TOKEN"

Réponses

  • 200 Réussi
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 422 Données refusées : le détail est donné champ par champ
  • 429 Trop d'appels : attendez Retry-After

Effacer les données d'un invité

POST/privacy/guest/erase

Portée : donnees:effacer Exporter et effacer les données personnelles d'un invité (RGPD)

Les rendez-vous restent dans les chiffres, vidés de l'invité ; les votes partent ; le désabonnement reste. Refusé (422) tant qu'un rendez-vous est à venir. Propriétaire. Jeton : portée `donnees:effacer`.

Création : l'en-tête Idempotency-Key évite un doublon pendant 24 heures.

Paramètres

NomOùTypeObligatoireDescription
Idempotency-Keyen-têtestringnonUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Corps de la requête

Exemple de requête
curl -X POST 'https://www.artibox-calendar.com/api/v1/privacy/guest/erase' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{"email":"camille.martin@example.com"}'

Réponses

  • 200 Réussi
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 409 Conflit : créneau pris ou requête en cours
  • 422 Données refusées : le détail est donné champ par champ
  • 429 Trop d'appels : attendez Retry-After

Effacer les invités des rendez-vous d'une période

POST/privacy/bookings/erase

Portée : donnees:effacer Exporter et effacer les données personnelles d'un invité (RGPD)

Les rendez-vous commencés dans [from, to[ restent dans les chiffres, vidés de l'invité (comme l'effacement par adresse). `to` doit être passé ; refusé (422) si un rendez-vous de la période est encore à venir. Propriétaire. Jeton : portée `donnees:effacer`.

Création : l'en-tête Idempotency-Key évite un doublon pendant 24 heures.

Paramètres

NomOùTypeObligatoireDescription
Idempotency-Keyen-têtestringnonUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Corps de la requête

Exemple de requête
curl -X POST 'https://www.artibox-calendar.com/api/v1/privacy/bookings/erase' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{"from":"2024-01-01T00:00:00+01:00","to":"2025-01-01T00:00:00+01:00"}'

Réponses

  • 200 Réussi
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 409 Conflit : créneau pris ou requête en cours
  • 422 Données refusées : le détail est donné champ par champ
  • 429 Trop d'appels : attendez Retry-After