Référence API
Vérifier une offre gratuite
Vérifier l’OTP et attribuer l’offre gratuite.
POST /api/portal/free-offer/verifyAccè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"
}| Attribut | Type | Description |
|---|---|---|
success | boolean | Confirme l’activation. |
claimId | string | Identifiant de la réclamation. |
purchaseId | string | Identifiant de l’achat créé. |
sessionId | string ou null | Session créée ou associée. |
username | string | Identifiant à utiliser si accessMode vaut credentials. |
password | string | Mot de passe retourné uniquement pour le mode credentials. |
accessMode | string | credentials ou mac. En mode mac, l’utilisateur doit reconnecter son appareil. |
idempotent | boolean | Pré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)