# 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.
- [Feed e report: recupero e parsing dei file](feed-e-report.md) — pattern `list*`→`get*`→download→`gzdecode`→TSV, gap sui feed (non documentati da Amazon), permessi per piano, varianza dei nomi campo, rimando ai doc EN sulle famiglie di report.

## Doc correlata (in `docs/en/`, autoriale del gruppo)

Conoscenza sui report scritta dal team dentro il mirror EN (da consolidare, vedi nota sotto):
[list-reports](../../en/api-reference/operations/list-reports.md) · [get-report](../../en/api-reference/operations/get-report.md) · [report-families](../../en/api-reference/operations/report-families.md).

## Da scrivere (backlog)

- Matrice credenziali × capacità (catalogo / feed / report) per version e marketplace.
- Note di parità con la futura versione Node della libreria.
