Skip to main content
POST
Émettre un jeton de session pour un poste (auth : clé lsk_)

Authorizations

Authorization
string
header
required

Locus API key — paste the raw lsk_… value (no 'Bearer ' prefix) — or a B2B session token minted by POST /v2/session-token.

Query Parameters

client
string
default:""

Agir au nom d'un AUTRE client, par son slug ou son identifiant. Réservé aux clés platform — la console que nous servons, où c'est une personne qui se connecte et non une clé. Omis : le client de la clé présentée, comme toujours.

Maximum string length: 200

Body

application/json
user_ref
string
required

Le compte au nom duquel le jeton vaut — le poste ou le praticien, tel que VOUS le nommez. Un identifiant opaque (l'empreinte d'un id interne, par exemple) : jamais un nom, jamais un patient. C'est sur lui que l'historique et les crédits sont cloisonnés.

Required string length: 1 - 200
scope
string | null

Ce que le jeton pourra faire, séparé par des espaces. Défaut : retrieve feedback history drugs logic. Restreindre ne se rattrape pas après coup — un jeton déjà distribué garde le sien jusqu'à son expiration.

Maximum string length: 200
ttl_seconds
integer | null

Durée de vie demandée, plafonnée à 86400 s. Défaut : 12 h.

Required range: 60 <= x <= 86400

Response

Successful Response

token
string
required
exp
integer
required

Expiration du jeton (secondes Unix).

absolute_exp
integer
required

Le plafond que le renouvellement ne franchira pas. Passé lui, il faut repartir d'un nouveau jeton — le dire d'avance évite à un poste de le découvrir en pleine consultation.

scope
string
required