Single-use booking links and signed links carrying a context (11.8).
List an event type's single-use links
GET/types/{id}/unique-links
Scope : types:lireRead event types, their slots and messages
Whole list by default; with page or limit, paginated (25 by default, 500 at most).
Parameters
Name
In
Type
Required
Description
page
query
integer
no
limit
query
integer
no
id
path
string
yes
page
query
integer
no
Numéro de page, à partir de 1
limit
query
integer
no
Éléments par page (500 au plus)
Request example
curl -X GET 'https://www.artibox-calendar.com/api/v1/types/{id}/unique-links' \
-H "x-api-key: $RDV_TOKEN"
Responses
200 Success
401 Missing, unknown or expired token
403 Missing scope or right refused
404 Not found (or another organisation's)
422 Data refused: details are given field by field
429 Too many calls: wait for Retry-After
Create a single-use link
POST/types/{id}/unique-links
Scope : liens:ecrireCreate single-use links, signed links and link sends
Creation: the Idempotency-Key header prevents duplicates for 24 hours.
Parameters
Name
In
Type
Required
Description
id
path
string
yes
Idempotency-Key
header
string
no
Une 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.
Request body
`{days?: 1–90 (14), note?}` — l'adresse n'est donnée qu'ici
Scope : liens:ecrireCreate single-use links, signed links and link sends
Creation: the Idempotency-Key header prevents duplicates for 24 hours.
Parameters
Name
In
Type
Required
Description
id
path
string
yes
Idempotency-Key
header
string
no
Une 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.
Request body
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)