Identifiants

Chaque objet exposé par l’API a un id composé d’un préfixe de type et d’un suffixe opaque de 22 caractères :


br_2xKq8Fh3LmN9pQrT4vWy6Z

Le préfixe dit d’un coup d’œil sur quoi pointe un ID — pratique dans les logs, les tickets de support et les tableurs. Les ID sont stables : un objet garde le sien à vie.

Préfixe	Objet
`org_`	Espace (organisation)
`br_`	Marque
`mkt_`	Marché d’une marque
`loc_`	Établissement d’une marque locale
`qry_`	Requête suivie (prompt)
`smp_`	Sampling — un cycle de mesure des modèles IA
`csync_`	Synchronisation du catalogue
`alrt_`	Alerte
`task_`	Tâche du backlog de correctifs
`prod_`	Produit
`var_`	Variante de produit
`comp_`	Concurrent suivi
`ord_`	Commande attribuée
`sheet_`	Fiche d’identité produit
`wb_`	Write-back — fiche ou codes-barres écrits dans la boutique
`evt_`	Event
`we_`	Endpoint de webhook
`whd_`	Tentative de livraison d’un webhook
`key_`	Clé API
`req_`	Requête API (voir l’en-tête `Request-Id`)

Règles

Traitez les ID comme des chaînes opaques. N’analysez pas le suffixe : son format peut changer.
Stockez-les en chaîne, jusqu’à 255 caractères.
Un ID du mauvais type est une ressource absente. Passer un alrt_… là où une tâche est attendue renvoie 404 resource_missing.