import { CardGrid, LinkCard, TabItem, Tabs } from '@astrojs/starlight/components';
import Faq from '@components/Faq.astro';
L'**API pubblica** (`/public/v1`) è una superficie REST curata di 5 risorse — lead, contatti, conversazioni,
appuntamenti e ticket — autenticata con una chiave API, disponibile nei piani **Pro** ed **Enterprise**.
## La tua prima richiesta
`GET /me` non richiede alcun permesso proprio — solo una chiave valida di un tenant con piano idoneo — quindi
è il modo più veloce per verificare che la tua chiave funzioni:
```bash
curl https://api.aymaragents.com/public/v1/me \
-H "X-API-Key: aa_TUA_CHIAVE_COMPLETA"
```
```python
import requests
res = requests.get(
"https://api.aymaragents.com/public/v1/me",
headers={"X-API-Key": "aa_TUA_CHIAVE_COMPLETA"},
)
res.raise_for_status()
print(res.json())
```
```javascript
const res = await fetch("https://api.aymaragents.com/public/v1/me", {
headers: { "X-API-Key": "aa_TUA_CHIAVE_COMPLETA" },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());
```
## Guide
## Riferimento generato
## Strumenti correlati
## Domande frequenti
/public/v1/* risponde 403 PLAN_NOT_ELIGIBLE, anche se la chiave esiste e ha lo scope corretto. Vedi Piani e limiti.' },
{ question: 'Cosa succede se la mia chiave non ha esattamente lo scope richiesto da un endpoint?', answer: 'Ricevi 403 PERMISSION_DENIED, anche con il resto dei suoi permessi intatti. Ogni risorsa ha due scope indipendenti — lettura e gestione. Vedi Autenticazione.' },
{ question: 'Come ruoto una chiave senza interrompere la mia integrazione?', answer: "Oggi non esiste un endpoint di rotazione atomica: crea una nuova chiave con gli stessi scope, aggiorna il segreto nella tua integrazione, poi revoca quella vecchia — c'è una breve finestra con entrambe attive." },
{ question: "Cosa restituisce l'API se chiedo una risorsa di un altro tenant?", answer: '404, esattamente come se la risorsa non esistesse — mai 403, che confermerebbe che il dato esiste su un altro account.' },
{ question: 'Quante richieste posso fare al minuto?', answer: '180/minuto e 50.000/giorno su Pro; 600/minuto e 200.000/giorno su Enterprise. La quota viene conteggiata per chiave, non per IP. Vedi Piani e limiti.' },
{ question: "Posso cancellare un lead, un contatto o qualsiasi altra risorsa tramite l'API?", answer: 'No — /public/v1 non ha nessun endpoint DELETE. Vedi Casi d\'uso dell\'API.' },
{ question: 'Cosa succede se invio un messaggio WhatsApp fuori dalla finestra di 24 ore?', answer: 'Ricevi 409 WHATSAPP_SESSION_WINDOW_CLOSED — usa invece POST /conversations/start con un modello approvato. Vedi Errori.' },
]} />
## Prossimo passo