URL d’enregistrement

Tout appel 2.1 qui résout un conteneur — redirect, retarget, modify — renvoie les quatre mêmes champs d’URL. Trois d’entre eux sont fixes. Le quatrième, url, ne l’est pas, et cette différence est le point le plus lourd de conséquences de toute cette API.

Les quatre champs

urlRead, urlWrite et urlPreview pointent chacun vers une seule destination, toujours la même. url est le champ historique par défaut, et c’est le seul dont la cible dépend de la plateforme appelante.

Champs d’URL
Champ	Pointe toujours vers
urlRead	https://{domain}/{urid} — l’URL de lecture, côté destinataire
urlWrite	https://{domain}/overwrite/{urid} — l’URL de réenregistrement, côté expéditeur
urlPreview	https://{domain}/preview/{urid} — l’ancienne URL d’aperçu
url	urlWrite si la plateforme dispose du service default_message, urlRead sinon

url dépend de la plateforme

url existe pour la rétrocompatibilité avec les intégrations qui ne lisent qu’un seul champ. Il vaut urlWrite quand la plateforme appelante dispose du service default_message, et urlRead pour toutes les autres plateformes. Un même appel, effectué avec deux clés d’API différentes, peut donc renvoyer deux destinations différentes dans url.

Deux réponses, côte à côte

Le même appel redirect, sur une plateforme standard puis sur une plateforme dotée de default_message — seul url diffère entre les deux.

plateforme standard

{
  "status": 0,
  "urid": "5f3e9c2b8a1d4f60",
  "urlRead": "https://livstick.io/5f3e9c2b8a1d4f60",
  "urlWrite": "https://livstick.io/overwrite/5f3e9c2b8a1d4f60",
  "urlPreview": "https://livstick.io/preview/5f3e9c2b8a1d4f60",
  "url": "https://livstick.io/5f3e9c2b8a1d4f60",
  "messageUrl": "livstick.io/5f3e9c2b8a1d4f60"
}

plateforme default_message

{
  "status": 0,
  "urid": "5f3e9c2b8a1d4f60",
  "urlRead": "https://livstick.io/5f3e9c2b8a1d4f60",
  "urlWrite": "https://livstick.io/overwrite/5f3e9c2b8a1d4f60",
  "urlPreview": "https://livstick.io/preview/5f3e9c2b8a1d4f60",
  "url": "https://livstick.io/overwrite/5f3e9c2b8a1d4f60",
  "messageUrl": "livstick.io/5f3e9c2b8a1d4f60"
}

messageUrl conserve l’ancien format

messageUrl n’est pas une cinquième alternative à url — c’est l’ancien format domain/{urid}, conservé pour les intégrations antérieures aux champs url*. Il ne comporte pas de schéma, contrairement à urlRead, urlWrite, urlPreview et url, qui sont toutes des URL HTTPS complètes.

Le QR code encode toujours urlRead

Quelle que soit la valeur de url pour une plateforme donnée, le QR code généré pour un conteneur encode toujours urlRead — l’URL de lecture côté destinataire, jamais la destination de réenregistrement ni celle d’aperçu.