Les métadonnées sont utiles à des fins de recherche ou d’organisation. Vous pouvez ajouter des métadonnées à votre transaction sous forme de paires clé-valeur (si la valeur est manquante, la clé sera ignorée). Vous pouvez ajouter jusqu’à 15 métadonnées par transaction. Chaque clé de métadonnée est limitée à 20 caractères, tandis que la valeur est limitée à 200 caractères. Les métadonnées sont destinées à un usage interne et ne sont pas affichées au participant.
Important : l’utilisation du signe égal (=), du signe plus (+) et du tiret bas (_) n’est pas prise en charge dans la clé de métadonnée. Les crochets ([]) ne sont autorisés que dans les paires d’ouverture et de fermeture, sinon ils sont ignorés.
Ajouter des métadonnées lors de la création d’une transaction
Pour définir des métadonnées lorsque vous créez une transaction, envoyez une requête à POST /v1/transactions et transmettez l’argument metadata, suivi de la clé de métadonnées entre crochets (par exemple metadata[contract_type]) :
curl
https://api.universign.com/v1/transactions \
-d metadata[account]=123456 \
-d metadata[contract type]=life insurance
Éditer les métadonnées d’une transaction en cours
Pour mettre à jour les métadonnées d’une transaction en cours, envoyez une requête à POST /v1/transactions/{transaction_id} et transmettez l’argument metadata :
curl
https://api.universign.com/v1/transactions/tx_AWo949MOq0JE \
-d metadata[contract type]=NDA
-d metadata[customer id]=5648547
Dans la requête ci-dessus, la nouvelle valeur des métadonnées contract type (NDA) écrasera la valeur précédemment transmise (life insurance) et de nouvelles métadonnées seront ajoutées à votre transaction (customer id: 5648547).
