Aller au contenu

Galaxie Artibox

Liens uniques et liens signés · Référence de l'API

Les liens de réservation à usage unique et les liens signés avec contexte (11.8).

Créer un lien unique

POST/types/{id}/unique-links

Portée : liens:ecrire Créer des liens uniques, des liens signés et des envois de lien

Création : l'en-tête Idempotency-Key évite un doublon pendant 24 heures.

Paramètres

NomOùTypeObligatoireDescription
idcheminstringoui
Idempotency-Keyen-têtestringnonUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Corps de la requête

`{days?: 1–90 (14), note?}` — l'adresse n'est donnée qu'ici

Exemple de requête
curl -X POST 'https://www.artibox-calendar.com/api/v1/types/{id}/unique-links' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{"days":14,"note":"Relance devis 2026-118"}'

Réponses

  • 201 Créé
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 409 Conflit : créneau pris ou requête en cours
  • 422 Données refusées : le détail est donné champ par champ
  • 429 Trop d'appels : attendez Retry-After

Créer un lien signé avec contexte

POST/types/{id}/signed-links

Portée : liens:ecrire Créer des liens uniques, des liens signés et des envois de lien

Création : l'en-tête Idempotency-Key évite un doublon pendant 24 heures.

Paramètres

NomOùTypeObligatoireDescription
idcheminstringoui
Idempotency-Keyen-têtestringnonUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Corps de la requête

11.6 : `{source, type, id, libelle?, prerempli?: {nom, email, telephone}, organisateur?, days?: 1–90 (14)}` — signé avec la clé de contexte de l'organisation (11.8)

Exemple de requête
curl -X POST 'https://www.artibox-calendar.com/api/v1/types/{id}/signed-links' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{"source":"mon-crm","type":"affaire","id":"AFF-2026-0042","libelle":"Projet Dupont","prerempli":{"nom":"Camille Martin","email":"camille.martin@example.com"},"days":14}'

Réponses

  • 201 Créé
  • 401 Jeton absent, inconnu ou expiré
  • 403 Portée manquante ou droit refusé
  • 404 Introuvable (ou d'une autre organisation)
  • 409 Conflit : créneau pris ou requête en cours
  • 422 Données refusées : le détail est donné champ par champ
  • 429 Trop d'appels : attendez Retry-After