Integrazione › Esempi pratici

Determinare se una targa è coperta da assicurazione

Vediamo ora un esempio di codice in TypeScript che mostra come effettuare una richiesta all'API per determinare se una targa è coperta da assicurazione o meno. Questo esempio include la gestione degli errori e l'uso di variabili d'ambiente per la chiave API.

Prima di utilizzare la chiave API, ti consigliamo di memorizzarla in un file .env, per evitare di esporla nel codice sorgente.

1
INFOTARGA_SECRET_KEY=sk_demo_00000000000000000000000000000000

Puoi utilizzare qualsiasi libreria per le richieste HTTP. In questo esempio utilizziamo fetch, che è disponibile sia in Node.js che nei browser moderni.

1
/**
2
 * Funzione per ottenere lo stato assicurativo di una targa
3
 * @param plate La targa da controllare
4
 * @return true se la targa è coperta da assicurazione, false se non lo è, null in caso di errore
5
 */
6
export async function getPlateInsuranceStatus(plate: string) {
7
    try {
8
        const endpoint = `https://infotarga.com/api/query/${plate}`
9
        const query = await fetch(endpoint, {
10
            method: 'POST',
11
            headers: {
12
                'Content-Type': 'application/json',
13
                'x-api-key': process.env.INFOTARGA_SECRET_KEY!,
14
            },
15
            body: JSON.stringify({
16
                includeInsurance: true,
17
            }),
18
        })
19

20
        if (!query.ok) {
21
            // Se incontriamo un errore in questa fase,
22
            // significa che c'è un problema di connessione con l'API
23
            throw new Error('Network response was not ok')
24
        }
25

26
        const response = await query.json()
27
        if (response.error) {
28
            // Se l'API restituisce un errore, gestiamolo qui
29
            // Ad esempio, potremmo voler controllare il codice di errore
30
            // e fornire un messaggio più dettagliato
31
            throw new Error(data.message)
32
        }
33
        if (!response.data.insurance) {
34
            // Quando non è possibile recuperare i dati assicurativi,
35
            // nonostante la richiesta sia andata a buon fine:
36
            // response.data.insurance === null
37
            throw new Error('Insurance data not available')
38
        }
39

40
        // Se tutto va bene, possiamo restituire lo stato assicurativo
41
        return response.data.insurance.compliant
42
    } catch (error) {
43
        console.error('Error fetching plate data:', error)
44
        return null
45
    }
46
}

Possiamo ora utilizzare questa funzione nel nostro codice principale per verificare lo stato assicurativo di una targa in modo dinamico, mostrando un messaggio diverso a seconda dello stato.

1
import { getPlate } from './api'
2

3
export async function main() {
4
    const plate = 'VE160LO'
5
    const insuranceStatus = await getPlateInsuranceStatus(plate)
6
    if (isInsured) {
7
        console.log(`La targa "${plate}" è coperta da assicurazione.`)
8
    } else if (insuranceStatus === false) {
9
        console.log(`La targa "${plate}" non è attualmente coperta da assicurazione.`)
10
    } else if (insuranceStatus === null) {
11
        console.log(`Non è stato possibile recuperare lo stato assicurativo per la targa "${plate}".`)
12
    }
13
}
14
main()

Per scoprire altre funzionalità dell'API consulta la documentazione completa, o visita il playground per testare le chiamate API in modo interattivo.

Scopri come integrare InfoTarga

Determinare se una targa è coperta da assicurazione