Skip to main content
llms.txt
API v2 Mis à jour le 07 Nov 2026 3 min de lecture

API Coworkies : démarrer

Connectez vos outils à l’API v2 avec une clé limitée, effectuez une première lecture et consultez les guides d’intégration.

L’API Coworkies permet de lire des offres et des données d’annuaire ou de créer des offres depuis vos outils. L’URL de base est https://api.coworkies.com/v2. Les réponses sont en JSON.

Retrait de l’API v1

L’API v2 est la seule API active. Les sélecteurs explicites de version v1 et les anciens alias du site renvoient HTTP 410 avec le code api_version_retired. Les chemins supprimés sur le domaine API renvoient HTTP 404. Ils ne redirigent pas vers v2.

Mettez les anciennes intégrations à jour vers https://api.coworkies.com/v2, transmettez la clé dans X-API-Key ou Authorization: Bearer, et utilisez les paramètres et formats de réponse actuels. Modifier uniquement le numéro de version ne suffit pas. L’alias index-api.php?version=v2&endpoint=... reste pris en charge pour les clients configurés, dont Slack. Le service MCP et l’intégration Slack utilisent l’API v2 ; le retrait de v1 ne modifie ni leur consentement ni leurs permissions. Consultez la disponibilité actuelle des intégrations pour connaître les clients pris en charge.

1. Obtenir une clé adaptée

Ouvrez User settings → API tokens, choisissez un espace Pro confirmé que vous gérez et créez un jeton. La rubrique API access de Space Admin présente les accès de l’équipe. Créer et gérer les jetons API.

Choisissez les permissions minimales. Une clé d’espace limite les données spécifiques prises en charge et les opérations sur les offres à cet espace. Les villes et les contenus publics ne sont pas tous filtrés par espace : consultez le comportement de chaque endpoint.

2. Effectuer une lecture

Configurez COWORKIES_API_KEY dans l’environnement du serveur ou son gestionnaire de secrets, puis exécutez :

curl --fail-with-body --max-time 30   'https://api.coworkies.com/v2/jobs'   -H "X-API-Key: ${COWORKIES_API_KEY}"

Vérifiez le statut HTTP et success. Les offres sont dans data.jobs. Une liste vide peut signifier que votre espace n’a pas d’offre active.

{
  "success": true,
  "status": 200,
  "data": { "jobs": [], "pagination": { "total": 0, "current_page": 1, "has_next": false, "next": null } }
}

Cet exemple présente quelques champs. Suivez data.pagination.next pour récupérer les pages suivantes. Voir API des offres.

3. Choisir un guide

Ressources développeur

RessourceUtilisation
Référence APIExemples et champs complets.
Swagger UIRéférence interactive ; les requêtes d’écriture peuvent modifier des données réelles.
Spécification OpenAPIImporter ou générer un client.
Référence LLM courteContexte d’intégration concis.
Référence LLM complèteDétails d’intégration.

La plupart des endpoints de données exigent une clé. Les informations API, retours, inscriptions newsletter, contenus de blog et flux Vine ont des routes publiques. Health, Jobs, Cities, Spaces et Events exigent une authentification. Gardez les clés côté serveur, jamais dans le code public du navigateur.

Slack et MCP

Pour la connexion, les méthodes de configuration et les permissions, consultez les Intégrations Slack et MCP. Les permissions d’une clé REST ne donnent pas automatiquement accès aux outils privés MCP.

Guides dans cette section

Sélectionnez un guide ci-dessous pour continuer