Aller au contenu
Accueil moxon

Génération d'UUID

L'endpoint /uuid génère des UUID v4 aléatoires, ou analyse un UUID existant pour en extraire la version et la variante.

gethttps://api.moxon.dev/v5/uuid

Comment ça marche ?

L'endpoint a deux modes. Lorsque uuid est fourni, il passe en analyse et count est ignoré. Sinon, il génère count UUID v4 aléatoires (un seul par défaut). Un UUID mal formé n'est pas une erreur : il est retourné avec valid: false et des composants à null.

Essayerget/v5/uuid

Paramètres

  • uuidstringoptionnel

    UUID à analyser. S'il est fourni, rien n'est généré et count est ignoré

  • countnumberoptionnel

    Nombre d'UUID à générer, un entier entre 1 et 50. Par défaut : 1

Variantes d'UUID

La variante est déduite du premier caractère du quatrième groupe :

CaractèreVariante
0 – 7NCS
8 – bRFC 4122
c – dMicrosoft
e – fFuture

Champs de réponse

UUID unique (généré, ou count à 1) :

  • uuidstring

    L'UUID généré

  • versionnumber

    Version de l'UUID — toujours 4 à la génération

  • variantstring

    Toujours RFC 4122 à la génération

Lot (count supérieur à 1) :

  • uuidsstring[]

    Tableau des UUID v4 générés

  • countnumber

    Nombre d'UUID retournés

Analyse (uuid fourni) :

  • uuidstring

    L'UUID fourni en entrée

  • versionnumber|null

    Version de l'UUID, null si l'entrée n'est pas un UUID valide

  • variantstring|null

    Variante de l'UUID, null si l'entrée n'est pas un UUID valide

  • validboolean

    Indique si l'entrée respecte le format UUID

Exemples de code

Gestion des erreurs

Si les paramètres sont manquants ou invalides, l'API retournera une erreur :

  • 400Please provide a valid UUID (?uuid={uuid})Le paramètre uuid n'est pas une simple valeur textuelle
  • 400Count must be a numberLa valeur de count n'est pas un nombre
  • 400Count must be between 1 and 50La valeur de count n'est pas un entier entre 1 et 50