# Consumo di prodotti dati tramite API

Attiva gli endpoint API per interrogare, filtrare e consumare i tuoi dati tra strumenti ed ecosistemi. Una volta attivati gli endpoint, è possibile accedere ai dati tramite API conformi a OData.

Nota informaticaÈ necessaria una delle seguenti sottoscrizioni:

* Qlik Talend Cloud Enterprise
* Qlik Talend Cloud Premium
* Qlik Cloud Analytics Premium
* Qlik Cloud Analytics Enterprise
* Qlik Sense Enterprise SaaS

## Attivazione degli endpoint API

Nota informaticaÈ necessaria l'autorizzazione per gestire i data product.

1. Dal menu Prodotti dati, fai clic sul prodotto dati per il quale desideri attivare gli endpoint API.

2. Dalla scheda Panoramica, fai clic su Modifica > Endpoint API.

   Viene visualizzata la finestra Modifica prodotto dati.

3. Seleziona i dataset per i quali desideri attivare gli endpoint API.

4. Fare clic su Salva.

   Sei tornato alla scheda Panoramica e l'opzione Endpoint API è disponibile nel menu Azioni nell'angolo in alto a destra.

   Gli endpoint API sono stati creati ed è possibile configurarli.

Quando il data product viene attivato sul marketplace, anche gli endpoint API vengono attivati nella versione attiva sul marketplace.

## Configurazione degli endpoint API

Dopo aver attivato gli endpoint API, puoi configurare la connessione che deve essere utilizzata per consumare i dataset.

Gli endpoint basati su file vengono utilizzati nello stesso spazio di archiviazione del set di dati.

1. Dalla scheda Panoramica, fai clic su the Icona Azioni icon > Usa in > Endpoint API.

   La finestra Endpoint API è aperta.

2. Se necessario, selezionare un'altra connessione.

   Le tue modifiche vengono automaticamente salvate.

## Utilizzo delle API

Una volta attivati gli endpoint API, puoi utilizzare le query per consumare i tuoi dati in altri strumenti.

Viene utilizzato il protocollo OData. Per ulteriori informazioni, vedere la [documentazione Microsoft](https://learn.microsoft.com/en-us/odata/overview).

Il formato di una query in Power Query o PowerBI è:`= OData.Feed("url-of-the-dataset", null, [Headers = [Authorization = "Bearer your-api-key"]])`

È necessario adattare quanto segue al proprio utilizzo:

* `url-of-the-dataset`. Sostituire questa parte con l'URL della finestra degli endpoint API.

  ![URL del dataset nella finestra degli endpoint API](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/di-endpoints-url.png)

* `your-api-key`. Sostituisci questa parte con la tua chiave API.

Nota di avvisoÈ possibile utilizzare le API solo per leggere i propri dati, non per scriverli.

1. Attiva gli endpoint API. Vedere la procedura sopra riportata.

2. Genera una chiave API se non ne hai già una. Per ulteriori informazioni, consulta [Generazione e gestione delle chiavi API](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-generate-api-keys.htm).

3. Apri lo strumento di tua scelta per recuperare i dati. In questo esempio viene utilizzato PowerBI.

4. Fare clic su Recupera dati > Query vuota.

5. immettere la query.

   Ecco un esempio di query che è possibile adattare e utilizzare in Power Query o PowerBI per recuperare dati da un set di dati.

   `= OData.Feed("https://qcs.us.qlikcloud.com/api/data-governance/data-access/data-products/687e50d58d4773120e843007/datasets/687e508ee636a966d6a6f9e4/connections/9d0d8a52-33a8-4d46-be28-068b4fd06282", null, [Headers = [Authorization = "Bearer your-api-key"]])`

6. Se desideri recuperare dati da altri set di dati, crea una query per ciascun set di dati.

7. Fare clic su Chiudi e applica per applicare le query.

8. Una volta importati i dati, definire le relazioni tra le tabelle.

9. Fai clic su Gestisci relazioni > Nuova relazione.

10. Seleziona le tabelle e salva.

11. Crea tutte le relazioni necessarie.

    Una volta configurate le relazioni, è possibile visualizzare i dati nei grafici.