Authentification

Chaque requête porte un jeton d'accès dans l'en-tête Authorization, précédé de Bearer :

curl https://api.propriz.fr/tenants \
  -H "Authorization: Bearer prz_votre_jeton"

Les jetons

  • Un jeton commence par prz_. Il n'est montré qu'une seule fois, à sa création : Propriz n'en garde qu'une empreinte et ne peut pas vous le redonner.
  • Dans le profil, un jeton se reconnaît à son nom et à ses premiers caractères, avec la date de sa dernière utilisation.
  • Dix jetons actifs au plus par compte.

Révoquer un jeton

Mon profil → API et intégrations → Révoquer. L'effet est immédiat : l'appel suivant avec ce jeton répond 401.

Révoquez un jeton dès que vous ne l'utilisez plus, ou au moindre doute sur sa confidentialité, puis créez-en un nouveau.

Bonnes pratiques

  • Un jeton par intégration : vous pourrez couper un outil sans toucher aux autres.
  • Jamais dans un dépôt de code, ni dans une page web ou une application mobile : gardez-le dans une variable d'environnement ou un gestionnaire de secrets.
  • Appelez l'API depuis un serveur, pas depuis le navigateur de vos utilisateurs.

Un jeton donne accès à tout votre compte : vos biens, vos locataires et leurs données personnelles. Traitez-le comme un mot de passe.