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

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

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.

Lire les données d’un espace

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).
`GET /v2/vine/jobs`, `/v2/vine/events`, `/v2/vine/blog`	Public	Flux légers ; voir les limites dans la référence.

Consultez OpenAPI, la référence API et le guide des erreurs pour les schémas et les routes complémentaires.