Support Questions

La chiamata di elenco Domande di Support ci permette, indicando il codice univoco della Card, di:

Ricevere l’elenco di Domande destinate alla Card indicata, per l’apertura di un eventuale Ticket;
Richiede in ingresso:
Codice univoco e identificativo della Card;
Restituisce:
L’elenco di domande;
Oppure, se non va a buon fine, la descrizione dell’errore riscontrato;

Chiave	Valore
Indirizzo Test	https://test-apiv2.smiletech.it/APIv2/Supports/SupportQuestions/{cardCode}
Indirizzo Prod	https://apiv2.smiletech.it/APIv2/Supports/SupportQuestions/{cardCode}
Metodo	GET
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.

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:

{ 
    "supportQuestions": 
    [ 
        { 
            "id": [long]{identificativo univoco della Domanda}, 
            "text": "[string]{testo descrittivo della Domanda}", 
            "order": [int]{ordine di visualizzazione della Domanda}, 
            "idDeviceType": [long]{id univoco del tipo di Device a cui sono associate le Domande}, 
            "deviceTypeName": "[string]{nome del tipo di Device a cui sono associate le Domande}"
        } 
    ]
}

Un esempio di chiamata con dati verosimili:

https://test-apiv2.smiletech.it/APIv2/Supports/SupportQuestions/003E5E25E4484094

Header

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

Request body

{

}

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

Response body

{ 
    "supportQuestions": 
        [ 
            { 
                "id": 7,
                "text": "Il computer è lento e ci impiega tanto a caricare",
                "order": 1, 
                "idDeviceType": 3,
                "deviceTypeName": "Computer"
            } 
        ]
}

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

Response

Status: 400 Bad Request

        {
            "error": "CardReleased non trovata per il codice fornito."
        }
        

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