Aller au contenu
ReadyZone Docs
Référence API

Vérifier une offre gratuite

Vérifier l’OTP et attribuer l’offre gratuite.

POST /api/portal/free-offer/verify

Accès : Public

Corps de requête

{
  "claimToken": "claim_token",
  "otp": "4920",
  "macAddress": "AA:BB:CC:DD:EE:FF"
}

claimToken est obligatoire. otp est requis lorsque la demande précédente indique otpRequired: true.

Corps de réponse

{
  "success": true,
  "claimId": "claim_uuid",
  "purchaseId": "purchase_uuid",
  "sessionId": "session_uuid",
  "username": "AA:BB:CC:DD:EE:FF",
  "password": "generated-password",
  "accessMode": "credentials"
}
AttributTypeDescription
successbooleanConfirme l’activation.
claimIdstringIdentifiant de la réclamation.
purchaseIdstringIdentifiant de l’achat créé.
sessionIdstring ou nullSession créée ou associée.
usernamestringIdentifiant à utiliser si accessMode vaut credentials.
passwordstringMot de passe retourné uniquement pour le mode credentials.
accessModestringcredentials ou mac. En mode mac, l’utilisateur doit reconnecter son appareil.
idempotentbooleanPrésent lorsque la même réclamation est confirmée à nouveau.

Codes de statut

  • 200 OK
  • 400 Bad Request (OTP ou token invalide)
  • 404 Not Found (réclamation introuvable)
  • 409 Conflict (réclamation déjà traitée)
  • 429 Too Many Requests (limite anti-abus)

Sur cette page