Activate License

La chiamata di attivazione Licenza Software per CardReleased permette, indicando il codice identificativo del Software selezionato e il codice univoco della Card, di:

Effettuare il rilascio della Licenza Software e ricevere i dati relativi necessari;

Richiede in ingresso:

Codice univoco e identificativo della Card;
Codice identificativo del Software;

Restituisce:

La Licenza e le specifiche del Software richiesto
Oppure, se non va a buon fine, la descrizione dell’errore riscontrato;

Chiave	Valore
Indirizzo Test	https://test-apiv2.smiletech.it/APIv2/Softwares/ActivateLicense/{cardCode}/{softwareCode}
Indirizzo Prod	https://apiv2.smiletech.it/APIv2/Softwares/ActivateLicense/{cardCode}/{softwareCode}
Metodo	PUT
Success Response	200 (Success)
Error Response	400 (Bad Request) 401 (Unauthorized) 500(Internal Server Error)

Di seguito la struttura dell’Header contenente:

Header

        {
            "authorization": "Bearer -indicare-qui-Token-fornito-"
        }
        

Il codice univoco della Card va inserito come parametro nell’URL andando a sostituire {cardCode} all’interno dell’indirizzo.

Il codice identificativo del Software va inserito come parametro nell’URL andando a sostituire {softwareCode} all’interno dell’indirizzo.

In questo caso il la struttura body di request non è necessaria e rimane vuota:

Request body

{ 

}

Di seguito la struttura della response contenente i valori di ritorno dal sistema:

Response body

{ 
    "name": "[string]{nome del Software}", 
    "code": "[string]{codice univoco del gruppo Software di appartenenza}", 
    "license": "[string]{licenza di utilizzo del Software, destinata al cliente finale}", 
    "downloadLink": "[string]{link di download del Software}", 
    "group": "[string]{nome del gruppo Software di appartenenza}", 
    "resultMessage": "[string]{messaggio di esito dell’operazione}"
}

Un esempio di chiamata con dati verosimili:

https://test-apiv2.smiletech.it/APIv2/Softwares/ActivateLicense/000B448AC749432C/KMS

Header

{ 
    "authorization": "Bearer NTNv7j0TuYARvmNMmWXo6fKvM4o6nv/aUi9ryX38ZH+L1bkrnD1ObOQ8Jdav"
}

Request body

{ 

}

In caso di Successo il sistema ritorna il seguente modello JSON:

Response body

{ 
    "name": "Kaspersky Mobile Security", 
    "code": "KMS", 
    "license": "AAAA1-BBBB2-CCCC3-DDDD4", 
    "downloadLink": "oaservice.it/internetsecurity.exe", 
    "group": "Antivirus", 
    "resultMessage": "Licenza rilasciata."
}

In caso di Errore il sistema ritorna il seguente modello JSON:

Response

Status: 500 Internal Server Error

        {
            "error": "Errore interno."
        }
        

Errori Riscontrabili

Di seguito la lista che indica gli errori che possono essere riscontrati:

Codice	Descrizione
400 (BadRequest)	I dati in ingresso non sono corretti o non sono correttamente formattati. Viene restituita la descrizione dell’errore nel dettaglio.
401 (Unauthorized)	Il codice Token fornito non è valido. L’autenticazione non è andata a buon fine.
500 (Internal Server Error)	Il server ha riscontrato un errore inaspettato, generalmente esula dal tipo di request e si verifica per problemi assoggettabili al sistema.

17 novembre 2025