Que legal, até então não sabia desta nova atualização. É fundamental. Aqui tem alguma documentação completa com essas informações sobre API ou só no Github?
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.