# Registrazione e utilizzo delle Chiavi API

### Prerequisito

Prima di tutto, devi avere creato e affinato [un memento](/it/uso-personale/personal/mementos-filter-access.md) utilizzando i tuoi file di conoscenza indicizzati.

### Creare una conoscenza comune

Per creare una conoscenza comune, accedi al tuo account Rememberizer e visita [la tua pagina di conoscenza comune](https://rememberizer.ai/personal/common-knowledge). Scegli **"La tua conoscenza condivisa"**, quindi fai clic su **"Inizia"**.

Poi scegli uno dei mementi che hai creato in precedenza, puoi anche scegliere **"Tutti"** o **"Nessuno"**.

<div align="center" data-full-width="false"><figure><img src="/files/Z9QcO66bBLS7Pe2VnLQT" alt="crea conoscenza comune 1" width="375"><figcaption></figcaption></figure></div>

Infine compila il nome della conoscenza comune, la descrizione e fornisci una foto rappresentativa.

<figure><img src="/files/4SnN3luqG3L7yB3Tml7L" alt="crea conoscenza comune 2" width="375"><figcaption></figcaption></figure>

Dopo aver compilato il modulo, fai clic su "Condividi conoscenza" in basso per creare la tua conoscenza comune. Dopodiché, attiva **"Abilita condivisione"** nella tua conoscenza e fai clic su **"Conferma"** nel pop-up.

Ora sei pronto per ottenere la sua API Key e accedere ai suoi documenti tramite chiamate API.

### Ottenere la chiave API di una conoscenza comune che hai creato

Per la tua conoscenza comune, fai clic sui tre punti in alto a destra, quindi scegli "Chiave API". Se non ce n'è ancora una, verrà creata per te. Se la chiave API esiste, verrà restituita.

Nel pannello **"Gestisci la tua chiave API"**, puoi fare clic sul pulsante **"occhio"** per mostrare/nascondere, sul pulsante **"copia"** per copiare la chiave negli appunti, e su **"Rigenera chiave API"** per invalidare la vecchia chiave e crearne una nuova (le app che accedono ai tuoi documenti tramite chiamate API non potranno accedere fino a quando non avrai aggiornato la nuova chiave in esse).

<figure><img src="/files/N9B0wSBV32cgKcaoX0Aq" alt="copia chiave API"><figcaption></figcaption></figure>

Dopo aver ottenuto la chiave API, puoi procedere a utilizzarla nelle tue chiamate API a Rememberizer per interrogare i tuoi documenti e contenuti indicizzati.

### Utilizzo della Chiave API

Per accedere agli endpoint di Rememberizer, utilizzerai la Chiave API nell'intestazione `X-API-Key` delle tue richieste API. Ti preghiamo di controllare la [Documentazione API](/it/risorse-per-sviluppatori/api-docs.md) per vedere gli endpoint forniti da Rememberizer.

Una volta ottenuta la tua chiave API, puoi utilizzarla in diversi modi:

1. **Accesso diretto all'API**: Utilizza la chiave API nelle tue richieste HTTP per interrogare gli endpoint di ricerca di Rememberizer
2. **Integrazione LangChain**: Utilizza l'[Integrazione LangChain](/it/risorse-per-sviluppatori/integration-options/langchain-integration.md) per incorporare le capacità di Rememberizer nelle tue applicazioni LangChain
3. **GPT personalizzato**: Utilizza la Chiave API in un'applicazione GPT personalizzata come descritto di seguito

#### Utilizzo con GPT personalizzati

Inizia [creando un GPT nell'interfaccia di ChatGPT](https://chat.openai.com/gpts/editor). Assicurati di scegliere il Tipo di Autenticazione come "API Key", Tipo di Autenticazione come "Custom" e l'intestazione come "X-Api-Key", quindi incolla la chiave che hai copiato in precedenza nella casella di testo della Chiave API.

{% hint style="info" %}
Per un'integrazione GPT più avanzata che utilizza OAuth invece delle chiavi API, vedi [Creazione di un GPT Rememberizer](/it/risorse-per-sviluppatori/integration-options/creating-a-rememberizer-gpt.md).
{% endhint %}

<figure><img src="/files/TnXlB8aXECcbM7qsVfsb" alt="gpt app using api key" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rememberizer.ai/it/risorse-per-sviluppatori/integration-options/registering-and-using-api-keys.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.