Aller au contenu
Accueil moxon

Analyse d'URL

L'endpoint /url décompose une URL en ses composants structurels : schéma, hôte, port, chemin, paramètres de requête et fragment. Les paramètres de requête dupliqués sont regroupés dans un tableau.

gethttps://api.moxon.dev/v5/url
Essayerget/v5/url

Paramètres

  • urlstringrequis

    URL absolue à analyser, incluant son schéma (ex. https://example.com/path?a=1)

Ports par défaut

Lorsque l'URL omet le port, le port par défaut du schéma est retourné :

SchémaPort
ftp21
http80
https443
ws80
wss443

Tout autre schéma retourne null.

Champs de réponse

  • urlstring

    L'URL d'entrée originale

  • schemestring

    Schéma de l'URL sans le : final (ex. https)

  • hoststring

    Nom d'hôte

  • portnumber|null

    Numéro de port — le port par défaut du schéma si l'URL ne le précise pas, null si le schéma n'a pas de port par défaut connu

  • pathstring

    Composant chemin

  • paramsobject

    Paramètres de requête — les clés dupliquées sont regroupées en tableau

  • fragmentstring

    Identifiant de fragment sans le # initial

  • validboolean

    Toujours true pour une URL analysée avec succès

Exemples de code

Gestion des erreurs

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

  • 400Please provide a URL (?url={URL})Le paramètre url est manquant
  • 400URL cannot exceed 2048 charactersL'url dépasse la longueur maximale
  • 400Invalid URLLa valeur url ne peut pas être analysée comme une URL