API & Développeurs

Authentification Bearer

Token API avec permissions granulaires (lecture / écriture). Stockage HMAC-SHA256.

60 req/min

Rate limiting généreux pour vos intégrations. Réponses JSON paginées.

Hébergé en France

HTTPS obligatoire, données isolées par tenant, conforme RGPD. Scaleway Paris.

Démarrage rapide

Trois étapes pour votre première requête API.

1

Activez l'API

Dans votre espace Skalo, allez dans Paramètres > API et activez l'accès.

2

Créez un token

Générez un token avec les permissions souhaitées. Conservez-le, il n'est affiché qu'une fois.

3

Faites votre premier appel

# Récupérer vos clients
curl https://votre-domaine.skalo.app/api/v1/clients \
  -H "Authorization: Bearer VOTRE_TOKEN" \
  -H "Accept: application/json"

API REST v1

Accédez à toutes vos données CRM en lecture et écriture. Authentification par Bearer token.

Méthode	Endpoint	Description
GET	/api/v1/clients	Liste paginée des clients
GET	/api/v1/clients/{id}	Détail d'un client
POST	/api/v1/clients	Créer un client
PUT	/api/v1/clients/{id}	Modifier un client
DELETE	/api/v1/clients/{id}	Supprimer un client

// Exemple : créer un client
fetch('https://votre-domaine.skalo.app/api/v1/clients', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer VOTRE_TOKEN',
    'Content-Type': 'application/json',
    'Accept': 'application/json',
  },
  body: JSON.stringify({
    name: 'Marie Dupont',
    email: 'marie@exemple.fr',
    phone: '06 12 34 56 78',
    company_name: 'Studio Lumière',
  })
})

Méthode	Endpoint	Description
GET	/api/v1/appointments	Liste des rendez-vous (filtres : status, from, to, client_id)
GET	/api/v1/appointments/{id}	Détail avec client, service, lieu
POST	/api/v1/appointments	Créer un rendez-vous
PUT	/api/v1/appointments/{id}	Modifier un rendez-vous
DELETE	/api/v1/appointments/{id}	Supprimer un rendez-vous
GET	/api/v1/availability	Vérifier la disponibilité (date, location_id, service_id)

Méthode	Endpoint	Description
GET	/api/v1/quotes	Liste des devis (filtres : status, client_id)
GET	/api/v1/quotes/{id}	Détail avec items, paiements, séances
POST	/api/v1/quotes	Créer un devis avec items
PUT	/api/v1/quotes/{id}	Modifier un devis
DELETE	/api/v1/quotes/{id}	Supprimer un devis

Méthode	Endpoint	Description
GET	/api/v1/invoices	Liste des factures (filtre : payment_status)
GET	/api/v1/invoices/{id}	Détail avec items et paiements
GET	/api/v1/invoices/{id}/pdf	Télécharger le PDF
GET	/api/v1/payments	Liste des créances (filtre : status, quote_id)
GET	/api/v1/payments/{id}	Détail d'une créance

Méthode	Endpoint	Description
GET	/api/v1/services	Liste des services (filtre : location_id)
GET	/api/v1/services/{id}	Détail d'un service
GET	/api/v1/locations	Liste des lieux
GET	/api/v1/locations/{id}	Détail d'un lieu avec services

Méthode	Endpoint	Description
GET	/api/v1/documents	Liste des documents (filtres : status, client_id)
GET	/api/v1/documents/{id}	Détail d'un document
POST	/api/v1/documents	Créer un document
POST	/api/v1/documents/{id}/send	Envoyer pour signature
DELETE	/api/v1/documents/{id}	Supprimer un document

Méthode	Endpoint	Description
GET	/api/v1/stats/dashboard	KPIs : CA, RDV, clients, devis, factures impayées
GET	/api/v1/stats/revenue	Ventilation CA (period : week/month/quarter/year)

API Booking

API publique pour intégrer le widget de réservation sur votre site. Aucune authentification requise.

Base URL : https://votre-domaine.skalo.app/api/booking/{uuid}

Méthode	Endpoint	Description
GET	/locations	Lieux disponibles
GET	/services/{locationId}	Services d'un lieu
GET	/staff/{locationId}	Membres de l'équipe
GET	/slots/{serviceId}/{date}	Créneaux disponibles (YYYY-MM-DD)
GET	/available-dates/{locationId}	Dates avec disponibilité (365 jours)
POST	/reserve	Créer une réservation
POST	/create-checkout	Créer un paiement Stripe/SumUp
GET	/payment-status/{sessionId}	Vérifier le statut d'un paiement

// Exemple : récupérer les créneaux disponibles
const response = await fetch(
  'https://studio.skalo.app/api/booking/abc-123/slots/1/2026-03-15'
);
const { slots, availableDates } = await response.json();

// slots = [{ time: "09:00" }, { time: "10:00" }, ...]
// availableDates = ["2026-03-15", "2026-03-16", ...]

Cas d'usage

🔗

Zapier / Make

Automatisez vos workflows : nouveau client dans votre CRM externe, notification Slack à chaque réservation, export vers Google Sheets.

🌐

Widget personnalisé

Créez votre propre formulaire de réservation avec l'API Booking. Intégrez-le sur votre site avec votre design.

📊

Tableau de bord externe

Récupérez vos KPIs via l'endpoint Stats pour alimenter un dashboard Power BI, Notion ou votre outil favori.

Codes de réponse

Code	Signification
200	Succès (lecture, modification)
201	Ressource créée
204	Suppression réussie
401	Token manquant ou invalide
403	Permission insuffisante (lecture seule vs écriture)
404	Ressource introuvable
409	Conflit (créneau déjà réservé)
422	Erreur de validation
429	Trop de requêtes (rate limit)

Questions fréquentes

Rendez-vous dans Paramètres > API de votre espace Skalo. Créez un token avec les permissions souhaitées (lecture, écriture ou les deux). Le token n'est affiché qu'une seule fois, conservez-le en lieu sûr.

Oui, l'accès API est inclus dans l'abonnement Skalo sans surcoût. Il suffit d'activer l'option API dans vos paramètres.

L'API REST est limitée à 60 requêtes par minute par token. L'API Booking (publique) est limitée à 60 requêtes par minute pour la lecture et 10 par minute pour les actions.

Toutes les communications passent par HTTPS. Les tokens sont stockés sous forme de hash HMAC-SHA256. Chaque tenant dispose de sa propre base de données isolée. Les données sont hébergées en France (Scaleway, Paris).

Oui, l'API REST est compatible avec tous les outils d'automatisation qui supportent les appels HTTP avec authentification Bearer token.

Prêt à intégrer ?

Créez votre compte, activez l'API et commencez à construire.

Démarrer l'essai gratuit Contacter l'équipe

Intégrez Skaloà vos outils