# Knowledge base interna

Conoscenza **prodotta dal gruppo** sulle Creators API e su tutto ciò che le
circonda: contratti verificati sul campo, comportamenti non documentati da Amazon,
scelte di integrazione, mappature verso i consumer interni.

A differenza di [`docs/it/`](../) (traduzione fedele della doc ufficiale) e
[`docs/en/`](../../en/) (mirror originale Amazon), qui il contenuto è **autoriale**:
può integrare, correggere o smentire la doc ufficiale quando la realtà osservata
diverge. Ogni pagina dichiara in testa la propria fonte (doc ufficiale, codice
libreria, uso in produzione nei consumer).

> Aggiornare le pagine di questa sezione nella stessa PR che cambia i fatti
> descritti, coerentemente con la policy del [CLAUDE.md](../../../CLAUDE.md) di progetto.

## Pagine

- [Autenticazione per credential version (2.x Cognito vs 3.x LwA)](autenticazione-per-versione.md) — quale flusso di token usa ciascuna versione, contratto completo, caveat operativi (v3 e feed, rate limit del token), mappatura verso `src/` e i consumer interni.

## Da scrivere (backlog)

- Operazioni feed e report (`listFeeds`/`getFeed`, `listReports`/`getReport`): forma reale delle risposte, download `.tsv.gz` → `gzdecode`, differenze tra credenziali.
- Matrice credenziali × capacità (catalogo / feed / report) per version e marketplace.
- Note di parità con la futura versione Node della libreria.
