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 fournit aussi les identifiants, le site et le lien LinkedIn. Ses coordonnées désignent la ville, tandis que spaces renvoie celles de l’espace. Les deux routes limitent les résultats à l’espace associé à la clé.

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.

Routes privées des espaces et des connexions

Utilisez un seul en-tête d’authentification pour GET /v2/auth/context. La réponse décrit le compte choisi, les permissions effectives, les actions disponibles et les motifs d’indisponibilité. Les droits sont revérifiés lors de l’écriture.

Vérifiez ce contexte avant toute opération de profil, localisation, soumission ou média. Soumettre un espace nécessite une autorisation propre et ne confère aucun droit de propriété. Préparer un média ou un aperçu ne publie pas de modification. Consultez les conditions de révision et de confirmation de chaque route dans la spécification OpenAPI.