Utilisateurs

GET /v1/users liste les personnes de votre entreprise. Il existe pour une raison pratique : que votre intégration puisse proposer un sélecteur « envoyer en tant que » au lieu de figer un seul expéditeur dans le code, puis transmettre l'e-mail de la personne choisie comme sender_email à l'envoi.

Nécessite le scope users:read. En lecture seule : aucun endpoint ne permet d'inviter, de modifier ou de supprimer un membre.

Paramètres de requête

Exemple de requête

curl "https://api2.bunnydoc.com/v1/users?status=accepted&per_page=100" \
  -H "Authorization: Bearer <access_token>"

GET /v1/users?status=accepted&per_page=100 HTTP/1.1
Host: api2.bunnydoc.com
Authorization: Bearer <access_token>

Réponse

{
  "data": [
    {
      "id": "018f6b2c-3d4e-7f5a-8b6c-7d8e9f0a1b2c",
      "email": "dana@yourco.com",
      "first_name": "Dana",
      "surname": "Lee",
      "name": "Dana Lee",
      "role": "admin",
      "status": "accepted",
      "products": ["eSign"]
    }
  ],
  "pagination": { "page": 1, "per_page": 25, "total": 1, "total_pages": 1 }
}

Choisir un expéditeur valide

Tout le monde dans la liste ne peut pas envoyer. Pour que sender_email se résolve, le membre doit remplir les deux conditions :

• status = accepted — une invitation en attente ou un membre archivé n'est pas un utilisateur actif, et
• détenir un siège eSign — vérifiez que products contient eSign.

Filtrez sur les deux avant de proposer quelqu'un dans un sélecteur :

const res = await fetch(
  "https://api2.bunnydoc.com/v1/users?status=accepted&per_page=100",
  { headers: { Authorization: `Bearer ${token}` } },
);
const { data } = await res.json();

const senders = data.filter((u) => u.products.includes("eSign"));

Tout autre cas vous donne 422 sender_not_found au moment de l'envoi.

Un cas dont cette liste ne peut pas vous avertir : un membre peut avoir une appartenance accepted alors que son compte utilisateur a été désactivé. Cela n'apparaît pas ici, donc traitez un 422 sender_not_found sur un membre par ailleurs éligible comme « cette personne ne peut plus envoyer » et repliez-vous sur un autre expéditeur ou sur le propriétaire de la clé.

Erreurs

Étapes suivantes