SparkGlim Développeurs
Donner le bon contexte à votre assistant.

Préparez une consigne depuis les documents vérifiés. Choisissez produit, technologie et assistant, puis copiez ou téléchargez le dossier public.
Choisissez votre produit API
Choisissez votre environnement technique
Choisissez votre assistant
Campagnes publiques et participation

Afficher les campagnes publiques admissibles et relier le parcours de participation pris en charge.
Prérequis: Utilisez uniquement les données publiques et les règles exactes de chaque opération.
Périmètre vérifié et limites: Les données publiques excluent acheteurs, donateurs, comptes privés et campagnes non publiées.
# SparkGlim — Campagnes publiques et participation

Aidez-moi à réaliser une intégration SparkGlim uniquement à partir des sources publiques vérifiées ci-dessous. Gardez le produit API choisi distinct des autres modèles d’accès.

Choisissez votre environnement technique: TypeScript
Choisissez votre assistant: Codex
Langue de la documentation: fr

## Expérience prévue

Afficher les campagnes publiques admissibles et relier le parcours de participation pris en charge.

## Prérequis

Utilisez uniquement les données publiques et les règles exactes de chaque opération.

## Architecture et limites de confiance

Utilisez le langage choisi pour HTTP côté serveur et gardez l’authentification privée sur le serveur. N’inventez ni SDK officiel ni commande d’installation.

Utilisez l’assistant comme aide au développement. Expliquez les changements proposés et faites primer les sources publiques sur les suggestions générées.

## Authentification et autorisations

L’accès dépend du compte approuvé, des domaines, portées, membres et visibilité. Choisir pays ou langue n’active pas les paiements et ne change pas la devise.

## Opérations vérifiées pour ce dossier

Seules les opérations implémentées et vérifiées figurent ci-dessous. Les opérations non vérifiées ou retirées sont exclues ; ne les remplacez pas par une route privée.

Les champs, types et validations ci-dessous sont des exigences de protocole, pas des données clients.

### GET /api/public/payment-methods/:campaignId — Options de paiement de la campagne

Liste les moyens activés pour pays vendeur, devise et client de la campagne approuvée, sans secrets.

Modèle d’accès: API publique

Contrat de requête:
- campaignId (path; string; Obligatoire): Campagne existante dans le compte et dans tout périmètre de clé de campagne plus limité. Validation : UUID ou identifiant de ressource documenté.
- app_type (query; enum; Facultatif): Contexte existant pour choisir configuration Web ou App ; aucune permission supplémentaire. Validation : user_app si sélectionné par l’utilisateur ; sinon web.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":{"methods":["item"],"currency":"string","country":"string"}}

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

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

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.

https://developer.sparkglim.net/reference/public/public-get-api-public-payment-methods-campaignId?lang=fr

### GET /api/public/tickets/public-verify — Vérification publique des billets

Transmet la vérification du billet au lecteur Web et conserve statut et résultat ; n’effectue pas l’entrée.

Modèle d’accès: API publique

Contrat de requête:
- code (query; string; Obligatoire): Identifiant ou code requis par cet endpoint ; ne publiez jamais de vrai OTP ou secret de billet. Validation : Identifiant d’accès au billet valide.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":{"ticket_code":"string","checked_in":"boolean","checked_in_at":"null","details_revealed":"boolean","campaign":{"title":"string","slug":"string","venue":"string"},"ticket_name":"string"}}

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

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

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.
Traitez les codes comme identifiants porteurs. Des détails peuvent apparaître après l’entrée ; la vérification ne l’autorise pas.

https://developer.sparkglim.net/reference/public/public-get-api-public-tickets-public-verify?lang=fr

### GET /api/public/blog — Articles publiés

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

Modèle d’accès: API publique

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

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":["item"],"count":"number","limit":"number","offset":"number"}

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

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

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.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog?lang=fr

### GET /api/public/blog/categories — Catégories des articles

Liste les catégories actives par position configurée puis nombre d’articles.

Modèle d’accès: API publique

Contrat de requête:
Aucun champ de requête documenté.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":["item"]}

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

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

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.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-categories?lang=fr

### GET /api/public/blog/:slug — Détail d’un article publié

Retourne un article publié et jusqu’à quatre articles liés, et augmente son compteur de vues.

Modèle d’accès: API publique

Contrat de requête:
- slug (path; string; Obligatoire): Identifiant d’URL pour la campagne ou l’article publié existant. Validation : Segment URL public.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":{"post":{"id":"string","slug":"string","title":"string","status":"string"},"relatedPosts":["item"]}}

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

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

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.
Lire un article augmente son compteur de vues. Ce GET n’est pas une inspection sans mutation.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-slug?lang=fr

### GET /api/public/homepage/discovery — Découverte des campagnes publiques

Recherche l’index public strict avec produit, pays, période, lieu et dates, puis retourne pagination exacte et données autorisées.

Modèle d’accès: API publique

Contrat de requête:
- q (query; string; Facultatif): Texte recherché dans titre, description, organisateur, lieu et bénéficiaire publics applicables. Validation : <=100.
- country (query; string; Facultatif): Filtre sur le pays configuré de la campagne ; n’active aucun paiement et ne convertit pas de devise. Validation : ISO2.
- location (query; string; Facultatif): Lieu public ou filtre de lieu ; distinct du pays de vente financier. Validation : <=100.
- type (query; enum; Facultatif): Type de ressource, réaction ou filtre de campagne pris en charge ici. Validation : all | ticketing | voting | donation.
- status (query; enum; Facultatif): État de cycle pris en charge ; les règles d’approbation contrôlent encore publication et accès. Validation : all | active | upcoming | ended | postponed.
- sort (query; enum; Facultatif): Sélectionne l’ordre serveur : mise en avant, nouveauté ou clôture. Validation : featured | latest | ending.
- date (query; enum; Facultatif): Limite la recherche à la période documentée du filtre serveur existant. Validation : all | today | tomorrow | weekend | month.
- page (query; integer; Facultatif): Page demandée selon la numérotation documentée ; conservez la pagination serveur. Validation : 1–1000000.
- limit (query; integer; Facultatif): Nombre maximum de données dans cette page ; la borne fixe de l’endpoint s’applique. Validation : 1–24 ; valeur par défaut : 12.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":{"entries":["item"],"countries":["item"],"locations":["item"],"pagination":{"page":"number","limit":"number","total":"number","pages":"number","hasMore":"boolean"},"available":"boolean"}}

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

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

La disponibilité est vérifiée dans le code, pas garantie en production.
Ne retournez que les données autorisées par le compte, la campagne et la visibilité.

https://developer.sparkglim.net/reference/public/public-get-api-public-homepage-discovery?lang=fr

### GET /api/public/homepage/campaigns — Campagnes de la page d’accueil

Retourne jusqu’à72 campagnes publiques actives pour un pays éventuel ; ce n’est pas un index complet paginé.

Modèle d’accès: API publique

Contrat de requête:
- country (query; string; Facultatif): Filtre sur le pays configuré de la campagne ; n’active aucun paiement et ne convertit pas de devise. Validation : ISO2.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":{"campaigns":["item"],"countries":["item"],"available":"boolean"}}

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

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

La disponibilité est vérifiée dans le code, pas garantie en production.
Campagnes publiques actives,72maximum, sans pagination.

https://developer.sparkglim.net/reference/public/public-get-api-public-homepage-campaigns?lang=fr

### GET /api/public/homepage/awards — Campagnes publiques de récompenses

Retourne jusqu’à200 votes publics approuvés, terminés ou reportés, par mise en avant et date de création.

Modèle d’accès: API publique

Contrat de requête:
- country (query; string; Facultatif): Filtre sur le pays configuré de la campagne ; n’active aucun paiement et ne convertit pas de devise. Validation : ISO2.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":{"campaigns":["item"],"countries":["item"],"available":"boolean"}}

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

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

La disponibilité est vérifiée dans le code, pas garantie en production.
Campagnes de vote uniquement,200maximum, sans pagination.

https://developer.sparkglim.net/reference/public/public-get-api-public-homepage-awards?lang=fr

### GET /api/public/countries — Catalogue des pays actifs

Retourne le catalogue actif des pays et devises par défaut ; ce n’est pas la liste des circuits de paiement activés.

Modèle d’accès: API publique

Contrat de requête:
Aucun champ de requête documenté.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":[{"code":"string","name":"string","phoneCode":"string","isDefault":"boolean","currency":"object"}]}

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

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

La disponibilité est vérifiée dans le code, pas garantie en production.
Le catalogue n’active ni paiements ni domaines nationaux.

https://developer.sparkglim.net/reference/public/public-get-api-public-countries?lang=fr

### GET /api/public/blog/:slug/reactions — Lire les réactions

Compte les réactions d’un article publié et les choix du visiteur sans retourner les identités des autres.

Modèle d’accès: API publique

Contrat de requête:
- slug (path; string; Obligatoire): Identifiant d’URL pour la campagne ou l’article publié existant. Validation : Segment URL public.
- visitorId (query; string; Facultatif): Identité de visiteur utilisée pour lire ou modifier sa réaction à l’article. Validation : Identité du visiteur.
- profileToken (query; string; Facultatif): Jeton d’un profil communautaire vérifié existant ; cet endpoint ne crée pas cette identité. Validation : Profil communautaire existant et vérifié.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":{"counts":{"like":"number","love":"number","insightful":"number","celebrate":"number","clap":"number"},"mine":["item"]}}

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

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

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

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-slug-reactions?lang=fr

### GET /api/public/blog/:slug/comments — Commentaires approuvés

Liste jusqu’à500 commentaires approuvés du plus ancien au récent, sans contact privé de l’auteur.

Modèle d’accès: API publique

Contrat de requête:
- slug (path; string; Obligatoire): Identifiant d’URL pour la campagne ou l’article publié existant. Validation : Segment URL public.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":["item"]}

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

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

La disponibilité est vérifiée dans le code, pas garantie en production.
500commentaires approuvés maximum, plus anciens d’abord, sans pagination.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-slug-comments?lang=fr

### GET /api/public/qr/ticket/:code — Image QR du billet

Retourne un PNG de marque de taille limitée pour le code ; le rendu ne donne pas propriété du billet.

Modèle d’accès: API publique

Contrat de requête:
- code (path; string; Obligatoire): Identifiant ou code requis par cet endpoint ; ne publiez jamais de vrai OTP ou secret de billet. Validation : UUID ou identifiant de ressource documenté.
- size (query; integer; Facultatif): Largeur de sortie QR limitée par le moteur existant. Validation : 128–1024 ; valeur par défaut : 512.

Statut HTTP de succès: 200

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

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

La disponibilité est vérifiée dans le code, pas garantie en production.
Réponse PNG binaire, pas JSON. Rendre un code n’autorise pas le contrôle d’entrée.

https://developer.sparkglim.net/reference/public/public-get-api-public-qr-ticket-code?lang=fr

### GET /api/participants/search — Recherche publique par code

Trouve un candidat approuvé ou vote public par code ou slug selon la visibilité et les catégories actives.

Modèle d’accès: API publique

Contrat de requête:
- code (query; string; Obligatoire): Identifiant ou code requis par cet endpoint ; ne publiez jamais de vrai OTP ou secret de billet. Validation : Code de candidat, participant ou campagne, ou segment URL de campagne ; q accepté comme alias.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","resultType":"string","participant":{"id":"string","name":"string","bio":"null","category":"null","vote_count":"null","show_vote_count":"boolean","participant_code":"string","nominee_code":"null","image_url":"null"},"campaign":{"id":"string","title":"string","slug":"string","status":"string","campaign_type":"string","vote_price":"number","image_url":"null","banner_url":"null"}}

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

Ce gestionnaire Web ne définit pas de limiteur dédié ; des contrôles en amont peuvent s’appliquer.

La disponibilité est vérifiée dans le code, pas garantie en production.
Ne retournez que les données autorisées par le compte, la campagne et la visibilité.

https://developer.sparkglim.net/reference/public/public-get-api-participants-search?lang=fr

### GET /api/public/voting-counts/:campaignId — Totaux publics selon visibilité

Retourne les votes terminés uniquement pour campagne publique, candidats approuvés et catégories actives lorsque les totaux sont publics.

Modèle d’accès: API publique

Contrat de requête:
- campaignId (path; string; Obligatoire): Campagne existante dans le compte et dans tout périmètre de clé de campagne plus limité. Validation : UUID ou identifiant de ressource documenté.

Statut HTTP de succès: 200
Contrat de réponse attendu: {"success":"boolean","data":{"visible":"boolean","voteCounts":{}}}

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

Ce gestionnaire Web ne définit pas de limiteur dédié ; des contrôles en amont peuvent s’appliquer.

La disponibilité est vérifiée dans le code, pas garantie en production.
Ne retournez que les données autorisées par le compte, la campagne et la visibilité.

https://developer.sparkglim.net/reference/public/public-get-api-public-voting-counts-campaignId?lang=fr

## Gestion des identifiants et requêtes

N’ajoutez jamais clés réelles, sessions, URL privées, contacts clients, codes ou campagnes non publiées. Utilisez des valeurs de substitution sans demander de secrets.

## Validation et reprise

Validez selon le schéma. Préservez références et clés d’idempotence lors des reprises, utilisez des nonces frais et ne répétez pas une erreur de validation ou de droits sans changement.

## Passage au paiement centralisé

Pour une participation payante, créez la session prise en charge sur le serveur et ouvrez l’URL checkout.sparkglim.net retournée. SparkGlim Server gère prestataire, vérification et exécution. N’ajoutez ni vérification ni interrogation du paiement dans le navigateur.

## Périmètre vérifié et limites

Les données publiques excluent acheteurs, donateurs, comptes privés et campagnes non publiées.

Une implémentation dans les sources ne prouve pas sa disponibilité en production. Consultez l’état actuel de l’API et son origine documentée avant utilisation. Si l’API requise est indisponible, arrêtez-vous et demandez la suite approuvée ; n’inventez pas de remplacement et n’appelez pas une API privée du tableau de bord.

## Sources publiques de référence

- https://developer.sparkglim.net/public-api?lang=fr
- https://developer.sparkglim.net/responses?lang=fr
- https://developer.sparkglim.net/security?lang=fr
- https://developer.sparkglim.net/api-status?lang=fr

## Instructions à conserver dans le dépôt

Lisez les instructions du projet. Réutilisez composants et transports, préservez les travaux sans rapport et proposez des tests ciblés. Aucun paiement, changement de compte ou message réel sans autorisation explicite.

Expliquez l’architecture, listez les opérations documentées exactes, puis proposez un plan minimal serveur/client. Indiquez les capacités indisponibles et demandez le contexte manquant sans demander de secrets.
Copiez ce dossier dans votre assistant ou ajoutez le fichier au projet. Choisir un assistant ne connecte aucun compte et n’envoie pas la consigne.
Utilisez uniquement la documentation publique et des valeurs de substitution. N’incluez ni identifiants, ni informations clients, ni données privées dans les consignes.
Campagnes publiques et participation

Poursuivre le développement
