# Amazon Product Advertising API (Deprecate)

{% hint style="danger" %}
Le Amazon Product Advertising API sono deprecate.<br>

Utilizzare le nuove [Amazon Creators API](/amazon-creators-api.md).
{% endhint %}

Il BOT utilizza le Amazon Product Advertising API ufficiali per l'ottenimento delle informazioni dei prodotti per i post creati dal BOT.

In questa guida si vedrà come ottenere e configurare le API sul BOT.

{% hint style="warning" %}
Nel caso in cui si dispongano di più affiliazioni Amazon (ad esempio paesi diversi), è sufficiente eseguire questa operazione solamente una volta (scegliere l'affiliazione principale).
{% endhint %}

### Generazione delle credenziali

Il primo passo sarà quello di generare la coppia **Chiave di accesso - Chiave segreta** tramite il pannello affiliazione Amazon.

1. Colleghiamoci al pannello di affiliazione Amazon all'indirizzo: <https://programma-affiliazione.amazon.it/home><br>
2. Selezionare il menu *Strumenti* in alto e poi *Product Advertising API*\
   ![](/files/zX4YxmW1qe4lch4FObzb)<br>
3. Scorrere in basso alla sezione Gestione delle credenziali<br>

   <figure><img src="/files/jEN5GJ51F3YQvXDebPG2" alt=""><figcaption><p><br></p></figcaption></figure>

   **IMPORTANTE:** Se non avevi attivato l'accesso alle API prima, ti verrà visualizzata la seguente schermata:<br>

   <figure><img src="/files/T0TRf1dyJqFKU2tJHwrp" alt=""><figcaption></figcaption></figure>

   Selezionare Richiesta di accesso alla PA API.\
   \
   **NOTA:** le chiavi API non funzioneranno da subito, sarà necessario attendere qualche ora prima che queste inizino a funzionare!<br>
4. Selezionare il pulsante *Aggiungi credenziali*\
   **Note:**
   1. E' possibile creare un massimo di due chiavi per account. Qualora aveste già due chiavi create eliminatene una per poi ricrearla;
   2. La chiave generata deve possibilmente essere utilizzata solo per questo BOT e non per altri servizi;
   3. Per poter generare le chiavi, il tuo account affiliazione deve essere stato approvato (almeno tre vendite idonee).<br>
5. Si riceveranno in risposta la *Chiave di accesso* e la *Chiave segreta*:<br>

   <figure><img src="/files/2N0ynawP95Ut1VSLQgCM" alt=""><figcaption></figcaption></figure>

   Copiare entrambe le chiavi in una posizione a piacere. Nella sezione successiva le inseriremo all'interno del BOT.\
   **Nota:** assicurarsi di copiare tutti i caratteri di entrambe le chiavi (vanno oltre la larghezza delle caselle).<br>
6. Una volta salvate le chiavi è possibile chiudere la pagina Amazon

{% hint style="warning" %}
Se eliminate le chiavi create dopo l'aggiunta sul BOT, queste smetteranno di funzionare
{% endhint %}

### Configurazione delle credenziali sul BOT

Ora si imposteranno sul BOT le chiavi generate nella sezione precedente.

1. Sul BOT navigare in *Impostazioni - API - Amazon Products Advertising API*.<br>

2. Selezionare *Configura API*<br>

3. Inviare come messaggio la *Chiave di accesso* generata nel punto 5 del paragrafo precedente<br>

4. Inviare poi come messaggio la *Chiave segreta* generata nel punto 5 del paragrafo precedente<br>

5. Ora verrà richiesto l'inserimento del *Partner ID*: questo deve coincidere con il Partner ID riportato *in alto a destra* nel Pannello Affiliazione dello stesso account utilizzato per la generazione delle chiavi API.

   <figure><img src="/files/Liu5y1dcM9wVI15cdWmo" alt=""><figcaption></figcaption></figure>

6. Dopo l'invio, se tutto è andato a buon fine, le chiavi API verranno applicate.\
   In caso di dati invalidi verrà invece visualizzato un errore e sarà necessario ripetere l'operazione.

{% hint style="warning" %}
Se si dovesse ricevere l'errore "**TooManyRequests**", e l'accesso alle chiavi API era appena stato richiesto, riprovare dopo qualche ora.
{% endhint %}

{% hint style="info" %}
Le stesse credenziali possono essere utilizzate su più BOT (canali).
{% endhint %}


---

# 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.dealsbot.io/amazon-product-advertising-api-deprecate.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.