Référence API

Articles publiés

Liste les articles publiés avec filtres de recherche, catégorie, mise en avant et pagination exacte.

GEThttps://api.sparkglim.net/api/public/blog

Modèle d’accès

Modèle d’accès: Accès public avec validation
Disponibilité documentée: Implémenté dans le code

La disponibilité est vérifiée dans le code, pas garantie en production.

Ouvrez l’URL de paiement retournée. SparkGlim Server contrôle prix, moyens, vérification et exécution ; le retour navigateur est uniquement une navigation.

Paramètres

Nom	Type	Validation
`category`Facultatif Catégorie configurée de campagne ou paramètres autorisés selon la ressource.	`string`	Validation : Segment URL de catégorie.
`search`Facultatif Filtre textuel appliqué aux données publiées sélectionnées par cet endpoint.	`string`	Validation : Texte de recherche.
`featured`Facultatif Active le filtre d’article mis en avant avec la valeur true.	`string`	Validation : true.
`limit`Facultatif Nombre maximum de données dans cette page ; la borne fixe de l’endpoint s’applique.	`number`	Validation : 1–30 ; valeur par défaut : 10.
`offset`Facultatif Nombre d’articles publiés à ignorer avant la page, à partir de zéro.	`number`	Validation : >=0 ; valeur par défaut : 0.

Requête

Les exemples décrivent le contrat et ne sont pas exécutés. Utilisez des données de test autorisées ; ne saisissez jamais de secret réel ici.

GET /api/public/blog

http

GET /api/public/blog HTTP/1.1
Host: api.sparkglim.net

Réponse

Réponse de succès · HTTP 200

json

{
  "success": true,
  "data": [],
  "count": 0,
  "limit": 10,
  "offset": 0
}

Réponse d’erreur · HTTP 400

json

{
  "success": false,
  "error": "<ERROR_MESSAGE>"
}

Validation, permissions, données indisponibles et pannes utilisent le statut HTTP et l’erreur du gestionnaire.

Limites et tentatives

Limite serveur par défaut : 100 requêtes par IP sur 60 secondes. Des contrôles spécifiques s’appliquent.

Compatibilité du code

Les opérations autorisées nécessitent des tests propres au compte.

server/src/api/router.ts
server/src/api/routes/public.ts