> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amply-app.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gérer les lieux et les points d’intérêt avec l’API REST

> Créez, listez et modifiez les lieux de votre carte interactive avec l’API REST Amply. Associez-les aux événements de votre agenda.

La ressource Places gère les lieux de votre carte interactive : scènes, stands d’exposants, équipements et points d’intérêt. Pour associer un lieu à un événement de l’agenda, utilisez le champ `place_id` de la ressource [Événements](/api-reference/events).

## Points de terminaison

| Méthode | Chemin | Description |
| - | - | - |
| `GET` | `/places` | Lister les lieux |
| `POST` | `/places` | Créer un lieu |
| `PUT` | `/places/{id}` | Modifier un lieu |

***

## GET /places — Lister les lieux

Renvoie les lieux définis sur la carte du projet.

### Exemple de requête

```bash theme={null}
curl https://api.amply-app.com/v1/places \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Exemple de réponse

```json theme={null}
{
  "data": [
    {
      "id": "plc_xyz789",
      "name": "Pavilion A24",
      "category": "exhibitor",
      "description": "Main exhibitor hall, ground floor.",
      "coordinates": { "x": 120, "y": 340 },
      "created_at": "2024-06-01T12:00:00Z"
    }
  ],
  "total": 12
}
```

***

## POST /places — Créer un lieu

Crée un lieu sur la carte du projet.

### Paramètres du corps

<ParamField body="name" type="string" required>
  Nom du lieu affiché au public, par exemple `"Pavilion A24"` ou `"Main Stage"`.
</ParamField>

<ParamField body="category" type="string">
  Catégorie du lieu, par exemple `"exhibitor"`, `"stage"` ou `"facility"`.
</ParamField>

<ParamField body="description" type="string">
  Description courte affichée aux visiteurs sur la carte.
</ParamField>

<ParamField body="coordinates" type="object">
  Position du lieu sur la carte, exprimée par les coordonnées `x` et `y` en pixels par rapport à l’image de fond.

  * `x` (integer) : position horizontale.
  * `y` (integer) : position verticale.
</ParamField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.amply-app.com/v1/places \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pavilion A24",
    "category": "exhibitor",
    "description": "Main exhibitor hall, ground floor.",
    "coordinates": { "x": 120, "y": 340 }
  }'
```

***

## PUT /places/{id} — Modifier un lieu

Modifie un lieu existant. Tous les champs sont facultatifs. Seuls ceux transmis sont modifiés.

### Paramètres du corps

<ParamField body="name" type="string">
  Nouveau nom du lieu affiché au public.
</ParamField>

<ParamField body="category" type="string">
  Nouvel identifiant textuel de la catégorie.
</ParamField>

<ParamField body="description" type="string">
  Nouvelle description du lieu.
</ParamField>

<ParamField body="coordinates" type="object">
  Nouvelles coordonnées sous forme d’objet contenant les entiers `x` et `y`.
</ParamField>

### Exemple de requête

```bash theme={null}
curl -X PUT https://api.amply-app.com/v1/places/plc_xyz789 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Main exhibitor hall — now on the first floor.",
    "coordinates": { "x": 130, "y": 355 }
  }'
```

***

## Champs de réponse

<ResponseField name="id" type="string">
  Identifiant unique du lieu, par exemple `"plc_xyz789"`.
</ResponseField>

<ResponseField name="name" type="string">
  Nom du lieu affiché au public.
</ResponseField>

<ResponseField name="category" type="string">
  Identifiant textuel de la catégorie associée au lieu.
</ResponseField>

<ResponseField name="description" type="string">
  Description courte affichée sur la carte interactive.
</ResponseField>

<ResponseField name="coordinates" type="object">
  Position du lieu sur la carte. Contient les coordonnées `x` et `y` en pixels, de type entier.
</ResponseField>

<ResponseField name="created_at" type="string">
  Horodatage de création du lieu au format ISO 8601.
</ResponseField>

<ResponseField name="updated_at" type="string">
  Horodatage de dernière modification du lieu au format ISO 8601.
</ResponseField>


## Related topics

- [Gérer les événements et les séances avec l’API REST](/api-reference/events.md)
- [Gérer les articles du blog avec l’API REST Amply](/api-reference/articles.md)
- [Gérer vos contenus avec l’API REST Amply](/api-reference/introduction.md)
- [Lister et enregistrer des webhooks avec l’API REST](/api-reference/webhooks.md)
- [Guider votre public avec le module Plan interactif](/modules/interactive-map.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.