Escrever uma referência de API pronta para uso

Escreva uma referência para a API a seguir.
API: [API]
Material: [Material]
Leitores: [Leitores]
Passos: 1. Liste todos os endpoints com método, caminho e uma frase sobre a finalidade. 2. Descreva, por endpoint, os parâmetros de caminho, consulta e corpo com tipo, obrigatoriedade, valor padrão e valores permitidos. 3. Mostre, por endpoint, uma chamada de exemplo completa e uma resposta de exemplo com marcadores no lugar de dados reais. 4. Liste todos os códigos de erro com a causa e o que quem chama deve fazer. 5. Explique em um só lugar autenticação, limites por tempo, paginação e versionamento. 6. Marque como pergunta em aberto tudo o que não puder deduzir com segurança do material.
Resultado: referência em Markdown, uma seção por endpoint e, no final, a lista de perguntas em aberto.

Preocupe-se especialmente em documentar só o que o material comprova e marcar o que for incerto como pergunta em aberto.

Antes de responder, confira: todas as instruções foram cumpridas? Se faltar uma informação importante ou ainda houver um campo entre colchetes no texto, pergunte em vez de adivinhar. Indique suposições como suposições.​