Aller à la documentation
SparkGlimDeveloper
Espace d’intégration avec l’IA
SparkGlimSparkGlim Développeurs
Rechercher dans toute la documentation

Essayez un sujet dans votre langue ou un chemin API exact.

    Navigation de la documentation

    Référence API

    Valider une réduction

    Valide une réduction existante via le contrat partagé ; l’achat vérifie encore prix final et admissibilité.

    POSThttps://api.sparkglim.net/api/public/discounts/validate

    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.

    Requête

    NomTypeValidation
    codeObligatoire

    Identifiant ou code requis par cet endpoint ; ne publiez jamais de vrai OTP ou secret de billet.

    		stringValidation : Réduction de campagne existante.
    campaign_idObligatoire

    Campagne existante dans le compte et dans tout périmètre de clé de campagne plus limité.

    		stringValidation : Identifiant de campagne.
    phone_numberFacultatif

    Téléphone du participant ; les moyens de paiement et règles peuvent exiger un numéro international valide.

    		stringValidation : Téléphone du client.
    emailFacultatif

    Email de contact utilisé par le parcours configuré ; il ne donne jamais accès à lui seul.

    		stringValidation : Adresse e-mail.

    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.

    POST /api/public/discounts/validate
    http
    POST /api/public/discounts/validate HTTP/1.1
Host: api.sparkglim.net
Content-Type: application/json

{
  "code": "<EXISTING_DISCOUNT>",
  "campaign_id": "11111111-1111-4111-8111-111111111111"
}

    Réponse

    Réponse de succès · HTTP 200
    json
    {
  "success": true,
  "discount": {
    "id": "11111111-1111-4111-8111-111111111111",
    "code": "<EXISTING_DISCOUNT>",
    "name": "Example discount",
    "discount_percent": 10,
    "campaign_id": "11111111-1111-4111-8111-111111111111"
  }
}
    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/routes/public.ts
    • app/api/discounts/validate/route.ts

    Poursuivre le développement