# Référence API de l’annuaire et des contenus

Source: https://docs.coworkies.com/fr/api/reference/

> Recherchez les villes et espaces, distinguez leurs coordonnées et trouvez les endpoints de blog, d’événements et de retours.

Les chemins ci-dessous sont relatifs à `https://api.coworkies.com`.

## Villes et espaces

| Endpoint | Permission | Paramètres et résultat |
|---|---|---|
| `GET /v2/cities` | `cities:read` ou lecture globale | `q` : identifiant URL exact ; `search` : nom partiel. Tableau `data` avec identifiants des villes. |
| `GET /v2/spaces` | `spaces:read` ou lecture globale | `q` : identifiant URL de ville. Espaces confirmés, limités à l’espace de la clé le cas échéant. |
| `GET /v2/city_spaces` | `spaces:read` ou lecture globale | Métadonnées des espaces/villes, site et LinkedIn disponibles. |

### Résoudre une ville

```bash
curl --fail-with-body --max-time 30   'https://api.coworkies.com/v2/cities?search=berlin'   -H "X-API-Key: ${COWORKIES_API_KEY}"
```

Les champs comprennent `id_city`, `city_name`, `city_slug`, `latitude` et `longitude`. Choisissez la bonne ville avant d’utiliser `id_city` pour [créer une offre](https://docs.coworkies.com/fr/api/jobs/).

### Lire les données d’un espace

```bash
curl --fail-with-body --max-time 30   'https://api.coworkies.com/v2/spaces?q=berlin'   -H "X-API-Key: ${COWORKIES_API_KEY}"
```

Les champs comprennent `space_name`, `space_url` (identifiant URL), `space_address`, `latitude`, `longitude` et `city_name`. `space_url` n’est pas une URL complète. Cet endpoint ne renvoie ni le tableau administratif des membres ni une galerie complète.

`city_spaces` ajoute les identifiants d’espace et de ville, le site et LinkedIn. Ses coordonnées représentent la **ville**, tandis que celles de `spaces` représentent **l’espace**. La réponse actuelle de `city_spaces` n’est pas limitée à l’espace de la clé. Ne supposez pas un filtrage identique pour tous les endpoints.

## Autres endpoints

| Endpoint | Authentification | Utilisation |
|---|---|---|
| `GET /v2` | Public | Informations et routes disponibles. |
| `GET /v2/blog` | Public | `category`, `tag`, `limit` (10 par défaut, 50 maximum), `offset` ; `slug` pour un article. |
| `GET /v2/events` | Requise ; lecture d’événements | Événements ; consultez la spécification pour les filtres. |
| `GET /v2/health` | Requise ; `read` | État du service. |
| `POST /v2/feedback` | Public | `message` obligatoire ; `email`, `url` et `category` facultatifs ; JSON ou formulaire. |
| `POST /v2/newsletters/subscribe` | Public | Inscription newsletter ; voir les exigences de consentement et de données dans la spécification. |
| `GET /v2/careers/{slug}` | Public | Flux JSON public du portail carrières d’un espace (`/v2/careers/brand/{slug}` pour une marque, ou `/v2/careers?host={hostname}` pour un sous-domaine personnalisé). Voir [Portail carrières et domaine personnalisé (Bêta)](https://docs.coworkies.com/fr/spaces/career-portal/). |
| `GET /v2/vine/jobs`, `/v2/vine/events`, `/v2/vine/blog` | Public | Flux légers ; voir les limites dans la référence. |

Consultez [OpenAPI](https://api.coworkies.com/openapi.yaml), [la référence API](https://api.coworkies.com/docs/) et [le guide des erreurs](https://docs.coworkies.com/fr/api/authentication/) pour les schémas et les routes complémentaires.