Find menu

Index > API > Listing page catégorie

Permet de retourner un listing de pages par catégorie en fonction de différents paramètres

Pour plus d’information sur les références globales, cliquez ici

Paramètres attendus :

nom	type	obligatoire	valeur par défaut	commentaire
category	String	OUI		Obligatoire
locale	String	NON	fr
page	int	NON	1
limit	int	NON	20

Informations

Requêtes CURL

curl --request GET \
--url --location '[url-de-mon-site]/api/v1/page/category?category=blog \
--header 'Accept: application/json' \
--header 'User-Token: [user-token' \
--header 'Authorization: Bearer [mon-token]'

curl --request GET \
--url --location '[url-de-mon-site/api/v1/page/category?category=blog&locale=es&page=5&limit=1 \
--header 'Accept: application/json' \
--header 'Authorization: Bearer [mon-token]'

Réponse 200

Pour un listing de page de type blog url : [url-de-mon-site]/api/v1/page/category?category=blog

{
  "code_http": 200,
  "message": "success",
  "data": {
    "pages": [
      {
        "title": "Dernières articles du blog",
        "slug": "blogs",
        "author": "contributeur@natheo.com",
        "created": 1730096624,
        "update": 1730096624
      },
      {
        "title": "Article de blog",
        "slug": "article-blog",
        "author": "contributeur@natheo.com",
        "created": 1730096624,
        "update": 1730096624
      }
    ],
    "limit": 25,
    "current_page": 1,
    "rows": 2
  }
}

Réponse 401

Si le token n’est pas valide

{
    "code_http": 401,
    "message": "Accès non autorisé",
    "errors": [
        "Token Invalide"
    ]
}

Réponse 403

Si le paramètre locale n’est pas valide

{
  "code_http": 403,
  "message": "Ressource non accessible",
  "errors": [
    "Choisir une locale entre fr (français) ou es (espagnol) ou en (anglais) "
  ]
}

Si le User-Token est présent mais faux et/ou périmé

{
    "code_http": 403,
    "message": "Ressource non accessible",
    "errors": [
        "Utilisateur non trouvé"
    ]
}

Si la catégorie n’existe pas

{
  "code_http": 403,
  "message": "Ressource non accessible",
  "errors": [
    "La catégorie recherchée n'existe pas"
  ]
}