Plateforme pour développeurs

Développez avec l'API CrewBox

CrewBox est fourni avec une API REST complète qui vous donne un accès programmatique à chaque fonctionnalité de la plateforme — projets, photos, tâches, documents, rapports et plus encore. Créez des intégrations, automatisez vos flux de travail et connectez CrewBox aux outils que votre équipe utilise déjà.

Obtenir l'accès à l'API

curl https://api.crewbox.pro/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY"

Une seule API pour toutes les fonctionnalités

Tout ce que vous pouvez faire dans l'application CrewBox, vous pouvez le faire via l'API.

Projets

Créez, lisez, mettez à jour et organisez les projets — y compris les adresses, les affectations d'équipe, les tags et les photos de couverture.

Photos et vidéos

Téléversez, récupérez et gérez les photos et vidéos de chantier, avec GPS, horodatages, légendes et annotations.

Tâches

Créez et assignez des tâches, définissez des échéances, suivez l'avancement et joignez des photos par programmation.

Documents et rapports

Générez des rapports PDF, gérez les documents et importez les rapports finalisés directement dans vos propres systèmes.

Tags et commentaires

Appliquez des tags, lisez et publiez des commentaires et des @mentions pour garder vos intégrations synchronisées avec le terrain.

Utilisateurs et notifications

Gérez les membres de l'équipe, les rôles et les accès, et connectez-vous aux événements de notification via des webhooks.

API

L'API REST

Chaque requête passe par une seule URL de base et est authentifiée avec un jeton bearer. Verbes REST standards, JSON en entrée et en sortie, et des URL de ressources prévisibles pour chaque objet dans CrewBox.

# List projects
GET https://api.crewbox.pro/v1/projects
Authorization: Bearer YOUR_API_KEY

# Response
{
  "data": [
    { "id": "prj_123", "name": "123 Main St", "status": "active" }
  ]
}

Webhooks

Enregistrez une URL et CrewBox y envoie une charge utile JSON dès qu'un événement se produit — sans interrogation. Chaque envoi est signé, vous pouvez donc vérifier qu'il provient bien de nous.

# CrewBox POSTs to your endpoint
POST https://your-app.com/webhooks/crewbox
X-CrewBox-Signature: sha256=…

{
  "event": "photo.created",
  "project_id": "prj_123",
  "data": { "id": "img_456", "url": "https://…" }
}

Abonnez-vous à des événements comme :

project.created     task.completed      photo.created
report.finished     comment.created     document.uploaded
project.updated     task.assigned       user.added

Comment fonctionne l'accès

1. Demandez l'accès

Inscrivez-vous ci-dessous pour rejoindre le programme développeur. Nous étudierons votre cas d'usage et provisionnerons votre compte.

2. Obtenez votre clé API

Recevez une clé API secrète limitée à votre espace de travail. Authentifiez chaque requête avec un simple jeton bearer.

3. Commencez à développer

Appelez les points de terminaison REST, abonnez-vous aux webhooks et livrez votre intégration avec notre documentation et notre support.