Scrivere un riferimento API utilizzabile subito

Scriva un riferimento per la seguente API.
API: [API]
Materiale: [Materiale]
Lettori: [Lettori]
Passaggi: 1. Elenchi tutti gli endpoint con metodo, percorso e una frase sullo scopo. 2. Descriva per ogni endpoint i parametri di percorso, query e corpo con tipo, obbligatorietà, valore predefinito e valori ammessi. 3. Mostri per ogni endpoint una chiamata di esempio completa e una risposta di esempio con segnaposto al posto di dati reali. 4. Elenchi tutti i codici di errore con causa e cosa deve fare chi chiama. 5. Spieghi in un unico punto autenticazione, limiti temporali, paginazione e versionamento. 6. Segni come domanda aperta tutto ciò che non può ricavare con sicurezza dal materiale.
Risultato: riferimento in Markdown, una sezione per endpoint e in fondo l'elenco delle domande aperte.

Fai particolare attenzione a documentare solo ciò che il materiale dimostra e segnare ciò che è incerto come domanda aperta.

Prima di rispondere, controlla: hai rispettato tutte le indicazioni? Se manca un'informazione importante o nel testo è rimasto un segnaposto tra parentesi quadre, chiedi invece di indovinare. Indica chiaramente le ipotesi.​