API · Rendez-vous & réservations

Connectez votre planning à SellViaApp.

Gérez services, ressources, horaires, indisponibilités, créneaux et réservations depuis votre logiciel tout en offrant une expérience mobile simple à vos clients.

URL de basehttps://api.sellviaapp.com/

En-têtes requisX-API-Key + Bearer

Support développeursapi@sellviaapp.com

Démarrage rapide

Authentifiez, choisissez une route, testez.

Récupérez la X-API-Key et générez le Bearer dans Dashboard → API. Entrez-les ci-dessous, puis utilisez « Tester · Générer » sur un endpoint pour obtenir la réponse et le code cURL, PHP 8 ou JavaScript.

X-API-Key

Bearer token

Accès incompletsRenseignez la X-API-Key et le Bearer token pour préparer un test.

Accès conservés uniquement en mémoire pendant cette page. Pour une opération liée à un client, ajoutez customer_id.

À retenirHTTPS + JSON · gardez les deux accès côté serveur · ne transmettez jamais les jetons au support.

Endpoints

Rendez-vous & réservations

Configurer les services, ressources, horaires et réservations depuis une app mobile, un ERP ou un logiciel métier.

33 routes

GET /booking/config/get Clé + Bearer

Lire les règles de réservation et la devise de l’app.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/config/update Clé + Bearer

Modifier les délais, l’annulation et les rappels. La double confirmation reste toujours active.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

min_notice_minutes integer Facultatif

Délai minimum avant réservation.

max_advance_days integer Facultatif

Nombre de jours réservables à l’avance.

cancellation_hours integer Facultatif

Délai d’annulation client.

public_booking boolean Facultatif

Autoriser la réservation mobile.

reminders_enabled boolean Facultatif

Activer la file des rappels.

reminder_hours integer Facultatif

Heures avant le rendez-vous.

customer_notes_enabled boolean Facultatif

Autoriser une note du client.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/service-category/list Clé + Bearer

Lister les catégories et sous-catégories de services.

Entrée

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/service-category/add Clé + Bearer

Créer une catégorie principale ou une sous-catégorie.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

name string Obligatoire

Nom de la catégorie.

parent_id integer Facultatif

Identifiant de la catégorie principale pour créer une sous-catégorie.

description string Facultatif

Description facultative.

color hex Facultatif

#RRGGBB

photo_base64 string Facultatif

Photo unique JPG, PNG ou WebP en base64 ou data URI.

photo_file_name string Facultatif

Nom facultatif du fichier.

photo_mime_type string Facultatif

image/jpeg | image/png | image/webp

active boolean Facultatif

Visible dans l’app.

sort_order integer Facultatif

Ordre d’affichage.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/service-category/update Clé + Bearer

Modifier le classement d’une catégorie de services.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Catégorie à modifier.

name string Obligatoire

Nom.

parent_id integer Facultatif

0 pour une catégorie principale.

photo_base64 string Facultatif

Une nouvelle photo remplace la photo actuelle.

remove_photo boolean Facultatif

Supprimer la photo actuelle.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/service-category/delete Clé + Bearer

Supprimer une catégorie inutilisée ou l’archiver.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Une catégorie utilisée sera archivée.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/service/list Clé + Bearer

Lister les services réservables et leurs ressources compatibles.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/service/detail Clé + Bearer

Récupérer la description détaillée et la galerie d’un service.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

service_id integer Obligatoire

Identifiant du service.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/service/add Clé + Bearer

Créer un service, sa durée, son prix et ses ressources.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

name string Obligatoire

Nom du service.

category_id integer Facultatif

Catégorie principale.

subcategory_id integer Facultatif

Sous-catégorie appartenant à category_id.

short_description string Facultatif

Texte court affiché sous le titre dans la liste mobile.

long_description string Facultatif

Présentation détaillée visible dans la fiche du service.

booking_mode enum Facultatif

appointment | duration | period | capacity

duration_minutes integer Facultatif

Durée réelle d’une réservation, de 5 à 10080 minutes.

slot_interval_minutes integer Facultatif

Fréquence des heures de départ. 0 ou omission = même valeur que duration_minutes.

capacity_required integer Facultatif

Places consommées par réservation.

price_type enum Facultatif

free | fixed | hourly | daily

price decimal Facultatif

Prix dans la devise de l’app.

deposit_type enum Facultatif

none | fixed | percent

deposit_value decimal Facultatif

Montant ou pourcentage.

location_mode enum Facultatif

business | customer | online | custom

address_required boolean Facultatif

Exiger une adresse client.

resource_ids array Obligatoire

Identifiants des ressources compatibles.

active boolean Facultatif

Service visible.

sort_order integer Facultatif

Ordre d’affichage.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/service/photo/add Clé + Bearer

Ajouter une photo à la galerie d’un service.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

service_id integer Obligatoire

Identifiant du service.

photo_base64 string Obligatoire

Image JPG, PNG ou WebP en base64 ou data URI.

file_name string Facultatif

Nom du fichier.

mime_type string Facultatif

image/jpeg | image/png | image/webp

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/service/photo/delete Clé + Bearer

Supprimer une photo de service.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

service_id integer Obligatoire

Identifiant du service.

photo_id integer Obligatoire

Photo à supprimer.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/service/photo/primary Clé + Bearer

Choisir la photo principale visible dans la liste mobile.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

service_id integer Obligatoire

Identifiant du service.

photo_id integer Obligatoire

Photo à utiliser dans la liste mobile.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/service/update Clé + Bearer

Modifier un service réservable.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant du service.

name string Obligatoire

Nom du service.

duration_minutes integer Facultatif

Durée réelle de la réservation.

slot_interval_minutes integer Facultatif

Fréquence des départs ; 0 utilise la durée du service.

category_id integer Facultatif

Catégorie principale.

subcategory_id integer Facultatif

Sous-catégorie.

resource_ids array Facultatif

Liste complète des ressources compatibles.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/service/delete Clé + Bearer

Supprimer un service inutilisé ou l’archiver.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Un service utilisé sera archivé.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/resource/list Clé + Bearer

Lister personnes, salles, véhicules, équipements et capacités.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/resource/add Clé + Bearer

Créer une ressource réservable.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

name string Obligatoire

Nom de la ressource.

resource_type enum Facultatif

description string Facultatif

Description interne ou visible.

capacity integer Facultatif

Capacité simultanée.

location string Facultatif

Lieu associé.

color hex Facultatif

#RRGGBB

active boolean Facultatif

Ressource active.

sort_order integer Facultatif

Ordre.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/resource/update Clé + Bearer

Modifier une ressource.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la ressource.

name string Obligatoire

Nom.

capacity integer Facultatif

Capacité simultanée.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/resource/delete Clé + Bearer

Supprimer une ressource inutilisée ou l’archiver.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Une ressource utilisée sera archivée.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/availability/list Clé + Bearer

Lister les horaires hebdomadaires.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/availability/add Clé + Bearer

Ajouter une plage horaire générale, propre à un service ou liée à une ressource.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

service_id integer Facultatif

Service concerné ; absent ou 0 pour tous les services.

resource_id integer Facultatif

Ressource concernée ; absent ou 0 pour toutes les ressources compatibles.

weekday integer Obligatoire

1 lundi à 7 dimanche.

start_time time Obligatoire

HH:MM

end_time time Obligatoire

HH:MM

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/availability/delete Clé + Bearer

Supprimer une plage horaire.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la plage.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/unavailability/list Clé + Bearer

Lister congés, fermetures et périodes bloquées.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/unavailability/add Clé + Bearer

Bloquer une période générale ou une ressource.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

resource_id integer Facultatif

Absent pour bloquer toute l’activité.

starts_at datetime Obligatoire

ISO 8601 avec fuseau conseillé.

ends_at datetime Obligatoire

Après starts_at.

reason string Facultatif

Motif facultatif.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/unavailability/delete Clé + Bearer

Supprimer une indisponibilité.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la période.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/slot/list Clé + Bearer

Lister les créneaux disponibles et ceux provisoirement en attente de confirmation administrateur.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

service_id integer Obligatoire

Service réservable.

resource_id integer Facultatif

Limiter à une ressource.

from_date date Facultatif

YYYY-MM-DD

days integer Facultatif

1 - 31

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/list Clé + Bearer

Lister les réservations autorisées.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

status enum Facultatif

limit integer Facultatif

1 - 200

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/detail Clé + Bearer

Récupérer une réservation et son historique.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la réservation.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/create Clé + Bearer

Créer et confirmer la demande côté client ; la validation administrateur reste ensuite requise.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

service_id integer Obligatoire

Service choisi.

resource_id integer Obligatoire

Ressource choisie.

starts_at datetime Obligatoire

Créneau retourné par booking/slot/list.

quantity integer Facultatif

Capacité utilisée.

address string Facultatif

Requis selon le service.

customer_notes string Facultatif

Note facultative.

customer_id integer Facultatif

Jeton fournisseur uniquement.

customer_name string Facultatif

Requis si aucun client lié.

customer_email email Facultatif

Adresse de contact.

customer_phone string Facultatif

Téléphone de contact.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/customer-confirm Clé + Bearer

Confirmer une réservation côté client.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

booking_id integer Obligatoire

Réservation appartenant au client connecté.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/admin-confirm Clé + Bearer

Confirmer, remettre en attente ou refuser la réservation côté administrateur.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

booking_id integer Obligatoire

Réservation à valider.

confirmation enum Obligatoire

pending | confirmed | rejected

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/update Clé + Bearer

Déplacer ou modifier une réservation.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Réservation à modifier.

service_id integer Obligatoire

Service.

resource_id integer Obligatoire

Ressource.

starts_at datetime Obligatoire

Nouveau début.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/status/update Clé + Bearer

Faire avancer une réservation déjà confirmée des deux côtés.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Réservation.

status enum Obligatoire

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/cancel Clé + Bearer

Annuler selon le délai configuré.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

booking_id integer Obligatoire

Réservation autorisée.

reason string Facultatif

Motif facultatif.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Endpoints

Paiements clients

Choisir le paiement à la livraison ou ouvrir un paiement Stripe sécurisé, puis consulter son état vérifié côté serveur.

4 routes

GET /payment/config Clé + Bearer

Récupérer les modes de paiement Stripe activés et le fournisseur Stripe sélectionné pour l’app.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /payment/checkout/create Clé + Bearer

Créer ou reprendre une page Stripe Checkout pour une commande ou réservation non payée appartenant au client connecté. Un choix de paiement à la livraison encore modifiable est remplacé en sécurité.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

purpose_type enum Obligatoire

order | booking

purpose_id integer Obligatoire

Identifiant de la commande confirmée ou de la réservation confirmée par le client.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /payment/pay-later Clé + Bearer

Enregistrer le paiement à la livraison ou remplacer un paiement Stripe encore ouvert après vérification et expiration sécurisée de sa session.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

purpose_type enum Obligatoire

order | booking

purpose_id integer Obligatoire

Identifiant de la commande ou réservation autorisée.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /payment/status Clé + Bearer

Consulter l’état d’un paiement ; seul le webhook Stripe signé peut confirmer le statut payé.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

reference string Facultatif

Référence SellViaApp du paiement. Sinon, fournir purpose_type et purpose_id.

purpose_type enum Facultatif

order | booking

purpose_id integer Facultatif

Identifiant de l’objet payé.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Référence

Réponses et erreurs

Chaque ligne possède un bouton « Paramètres et réponses » qui indique les champs obligatoires ou facultatifs, les statuts possibles et des exemples JSON. Une liste vide signifie que la ressource n’est pas encore alimentée, pas que la route est en panne.

400Requête invalide

401Authentification requise

403Accès refusé

404Ressource ou route absente

409Conflit métier

422Validation impossible

429Trop de requêtes

5xxIncident technique

Atelier API

Endpoint

GET

Paramètres URLUne ligne par paramètre : nom=valeur Corps JSONModifiez les valeurs d’exemple avant le test.

Le code généré contient les accès saisis. Conservez-les côté serveur et ne partagez jamais une capture non masquée.

Réponse API