POST
/api/v1/clientsCréer un client
Ajoute un client à l'organisation. Un projet a toujours un client.
Crée un client dans l'organisation de la clé. Rien n'empêche deux clients homonymes : cherchez d'abord si vous n'êtes pas sûr qu'il n'existe pas déjà.
Corps de la requête
| Champ | Type | Requis | Contraintes |
|---|---|---|---|
name | string | oui | 1 à 200 caractères |
email | string | Email valide | |
phone | string | 40 caractères max | |
company | string | 200 caractères max | |
address | string | 300 caractères max | |
city | string | 120 caractères max |
Cette route accepte un en-tête Idempotency-Key.
Exemple
curl -X POST "https://www.tetikasa.app/api/v1/clients" \
-H "Authorization: Bearer $TETIKASA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Acme","email":"contact@acme.fr","company":"Acme SAS"}'Réponse
Statut 201. Le slug est dérivé du nom et suffixé en cas de collision dans
l'organisation (acme, puis acme-2). address et city sont enregistrés
mais ne figurent pas dans la représentation renvoyée.
Erreurs
code | Statut | Quand |
|---|---|---|
invalid_request | 422 | Corps JSON invalide, ou un champ hors contraintes — details liste les champs fautifs |
unauthorized | 401 | Clé absente, invalide, révoquée ou expirée |
