A API REST Notiondesk permite que você execute suas centrais de ajuda a partir de código. Leia artigos, coleções e entradas de changelog, gerencie redirecionamentos de página, atualize configurações, identidade visual e integrações, exporte análises e feedback dos leitores e acione sincronizações do Notion. Você ainda escreve seu conteúdo no Notion: a API o lê e sincroniza, não o edita.
URL base
Envie todas as solicitações para https://api.notiondesk.so. Os caminhos dos endpoints começam com /sites, e as solicitações e respostas usam JSON.
Autenticação
Cada requisição carrega um token de portador no cabeçalho Authorization:
curl https://api.notiondesk.so/sites \
-H "Authorization: Bearer $NOTIONDESK_API_KEY"- Chave de API : para seus próprios scripts, tarefas agendadas e CI. O proprietário do espaço de trabalho ou um administrador a cria em Configurações > Desenvolvedores > Chaves de API. As chaves começam com
nd_wsk_e funcionam para todas as centrais de ajuda no espaço de trabalho. Consulte Autenticar com a API Notiondesk usando chaves de API .
- Token de acesso OAuth : para aplicativos aos quais outros clientes da Notiondesk se conectam. Consulte Conecte seu aplicativo à Notiondesk com OAuth .
Cada endpoint precisa de um escopo: read, write, sync ou admin. A página de cada endpoint mostra qual deles.
Exemplos de código
Cada página de endpoint lista seus parâmetros, corpo da requisição e respostas, com exemplos de código prontos para copiar em cURL, JavaScript e Python.
Guias
- Comece a usar a API REST do Notiondesk : sua primeira solicitação, passo a passo.
- Guias de primeiros passos : chaves de API, OAuth, paginação e versões, erros e limites de taxa, e exemplos.
- Webhooks : receba uma solicitação em seu servidor quando algo acontecer em Notiondesk.