Expiring

La chiamata Expiring permette, indicando data di inizio e data di fine, di:

Recuperare l’elenco delle Card in scadenza (Card con data di scadenza rientrante nel range temporale indicato);

Richiede in ingresso:

Data di inizio (yyyy-MM-dd);
- Impostata a orario “00:00:00” per il giorno indicato;
Data di fine (yyyy-MM-dd);
- Impostata a orario “23:59:59” per il giorno indicato;

Restituisce:

L’elenco delle Card in scadenza con i relativi parametri;
Oppure, se non va a buon fine, la descrizione dell’errore riscontrato;

Chiave	Valore
Indirizzo Test	https://test-apiv2.smiletech.it/APIv2/CardReleaseds/Expiring {start}/{end}
Indirizzo Prod	https://apiv2.smiletech.it/APIv2/CardReleaseds/Expiring/{start}/{end}
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 range di date va inserito come parametro nell’URL andando a sostituire {start} ed {end} all’interno dell’indirizzo.

In questo caso 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

{ 
    "cardReleaseds": [ 
        { 
            "cardCode": "[string]{codice univoco Card, necessario per usufruire del servizio e dei prodotti associati}", 
            "serviceCode": "[string]{codice del servizio fornito}", 
            "serviceName": "[string]{nome del servizio fornito}", 
            "serviceEAN": "[string] {codice EAN del servizio}", 
            "dateActived": "[DateTime] {data/momento di attivazione della Card}", 
            "dateExpired": "[DateTime] {data/momento di scadenza della Card}", 
            "cardSerial": "[string] {seriale retro della Card}", 
            "codeRenewed": "[string] {codice univoco Card padre (se Card rinnovo)}", 
            "shopName": "[string] {nome del negozio}", 
            "shopCode": "[string] {codice del negozio}", 
            "companyName": "[string] {nome del socio}" 
        }
    ]
}

Un esempio di chiamata con dati verosimili:

https://test-apiv2.smiletech.it/APIv2/CardReleaseds/Expiring/2025-07-01/2024-07-31

Header

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

Request body

{ 

}

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

Response body

{ 
    "cardReleaseds": [ 
        {
            "cardCode": "7AB22D1A685E43DE", 
            "serviceCode": "SIRTIE12COMPUTE", 
            "serviceName": "SERVIZIO COMPUTER", 
            "serviceEAN": "2000009904406", 
            "dateActived": "2024-07-16T15:17:43.0147965",
            "dateExpired": "2025-07-16T15:17:43.5238762", 
            "cardSerial": "1234q", 
            "codeRenewed": null, 
            "shopName": null, 
            "shopCode": null, 
            "companyName": "EURONICS" 
        }
    ]
}

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