API para desenvolvedores

Automatize o Papyro a partir dos seus próprios sistemas

Uma API REST versionada com uma especificação OpenAPI 3.1, chaves de API com escopo e idempotência — além de um servidor MCP para que assistentes de IA possam trabalhar dentro do seu espaço de trabalho.

API para desenvolvedores Demo ao vivo

curl https://your-papyro.example.com/api/v1/boards \
  -H "Authorization: Bearer papyro_•••"

{
  "data": [{ "id": "brd_1", "name": "Roadmap" }],
  "next_cursor": null
}

API REST versionada

Uma superfície estável /api/v1 para quadros, listas, cartões (com comentários), notas, espaços, clientes e chamados de helpdesk e os relatos dos seus utilizadores finais — documentada por uma especificação OpenAPI 3.1 escrita à mão, que a sua própria instância disponibiliza.

Servidor MCP para assistentes de IA

Qualquer cliente MCP pode ler e escrever nos seus quadros e notas através de 12 ferramentas — listar, criar e atualizar cartões (mover, atribuir, etiquetar), criar listas, ler e escrever notas, e triar fingerprints de erro. Autentique com OAuth 2.1 (a sua instalação é o seu próprio servidor de autorização) ou uma chave papyro_ com escopo. Cada chamada é auditada, e um único interruptor de administrador corta o acesso de todos os clientes.

Chaves de API com escopo

Emita chaves papyro_ nas Configurações, envie-as como um token Bearer ou cabeçalho x-api-key, e conceda a cada integração apenas os escopos de que ela precisa.

Ingestão de erros nos quadros

Aponte os seus serviços para /api/v1/boards/{id}/fingerprints e o Papyro agrupa os eventos, registra a primeira e a última ocorrência, dispara o seu webhook e pode escrever uma análise de causa raiz diretamente no cartão. O seu próprio monitoramento de erros, no seu próprio servidor.

Idempotência e paginação

Paginação por cursor e chaves de idempotência tornam as requisições em massa e reenviadas seguras e previsíveis.

Limites de taxa que você pode ver

Cada resposta carrega cabeçalhos de limite de taxa, para que seu cliente sempre saiba em que ponto está.

A referência interativa completa da API vem dentro de cada instância do Papyro em /api/v1/docs, com a especificação bruta em /api/v1/openapi.json. O endpoint MCP fica em /api/mcp e se anuncia através dos documentos padrão de descoberta OAuth.