Infelizmente não existe uma documentação da API, e até tem a issue #555 sobre isso no GitHub. A única "documentação" é o código, mesmo.
Caso você queira saber os parâmetros de um endpoint, pode procurar o arquivo em pages/api/v1/...
e ver o ...ValidationHandler
. Nesse caso, o arquivo é pages/api/v1/contents/index.public.js
e a função é getValidationHandler
:
function getValidationHandler(request, response, next) {
const cleanValues = validator(request.query, {
page: 'optional',
per_page: 'optional',
strategy: 'optional',
with_root: 'optional',
with_children: 'optional',
});
Sei que isso não é prático, e não necessariamente os nomes escritos aí são os nomes dos parâmetros (eles são os nomes dos "validadores"), mas isso pode dar uma ajuda em casos simples. Se ter alguma dúvida sobre a API, pode perguntar no GitHub.