---
title: "Publier un avis sur une commune"
method: POST
path: "/communes/{insee}/avis"
---

# Publier un avis sur une commune

`POST /communes/{insee}/avis`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/communes/{insee}/avis`
- Auth: HTTP bearer

Publie l'avis de l'utilisateur de la clé sur une commune, avec les règles du site : note globale de 1 à 5, quatre notes facultatives, titre, texte et profil. Un seul avis par compte et par commune ; un second est refusé. L'avis est servi ensuite sans l'identité de son auteur. Exige une clé rattachée à un compte Pillr. Coût : 0 crédit par appel réussi.

## Path parameters

- `insee` string, required: Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).

## Request body

- object
  - `note` integer, required: Note globale, de 1 à 5.
  - `note_rentabilite` integer
  - `note_qualite_vie` integer
  - `note_demande_locative` integer
  - `note_valorisation` integer
  - `titre` string, required
  - `contenu` string, required
  - `profil` 'proprietaire' | 'locataire' | 'investisseur' | 'professionnel': Votre profil : proprietaire, locataire, investisseur ou professionnel.

## Response `201`

Ressource créée.

- object
  - `id` string, required
  - `insee` string, required
  - `commune` string, nullable, required
  - `cree_le` string, nullable, required
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante ; Clé sans compte rattaché
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible ; Donnée momentanément indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)