rubis/bruno/03-Clients/04 Create.bru
ordinarthur 27cfa9ac13 docs(bruno): collection complète des routes API + environnement local
Collection Bruno (.bru text files, comme Postman mais file-based versionable) qui couvre l'API V1 actuelle. Open Collection → bruno/ → sélectionner l'environnement "local".

Domaines couverts (22 requêtes) :
- 00-Auth : Signup, Login, Logout
- 01-Account : Get/Update profile
- 02-Organizations : Get/Update my org
- 03-Clients : List, List+stats, Search, Create, Create duplicate (409), Create without email (422), Get detail, Update
- 04-Plans : List, Get by slug, Update (steps remplacés)
- 05-Invoices : List, List+filters, Counts, Create, Get detail, Mark paid

Environnement local (bruno/environments/local.bru) :
- baseUrl, email/password/fullName en dur
- token, userId, organizationId, clientId, invoiceId remplis automatiquement par les script:post-response

Chaque requête a :
- assertions Chai (statut, shape de la réponse)
- bloc docs avec sémantique métier + erreurs typiques
- inheritance auth Bearer via folder.bru pour ne pas répéter le header

Mise à jour de docs/tech/dev-setup.md pour pointer vers la collection.

Le parcours recommandé Signup → Update org → Create client → Create invoice → Mark paid couvre le happy path et permet de checker rubisCount qui s'incrémente.
2026-05-06 14:40:55 +02:00

48 lines
882 B
Plaintext

meta {
name: 04 Create
type: http
seq: 4
}
post {
url: {{baseUrl}}/api/v1/clients
body: json
auth: inherit
}
body:json {
{
"name": "Boulangerie Martin SARL",
"email": "compta@martin.fr",
"phone": "06 12 34 56 78",
"siret": "12345678901234",
"notes": "Bon payeur historique"
}
}
script:post-response {
if (res.getStatus() === 201) {
bru.setEnvVar("clientId", res.getBody().data.id);
}
}
tests {
test("201 Created", function () {
expect(res.getStatus()).to.equal(201);
});
test("clientId saved to env", function () {
expect(bru.getEnvVar("clientId")).to.not.be.empty;
});
}
docs {
POST /api/v1/clients
Création manuelle. Email **requis** (pivot produit). SIRET = 14 chiffres
exactement si fourni.
Capture `clientId` dans l'env pour les requêtes suivantes (détail,
update, création de facture).
}