{
  "nome": "Paper",
  "sobre": "Paper é um caderno de notas (wire.ia.br). As notas pessoais ficam no aparelho da pessoa e no Google Drive dela, em arquivos .md. O Paper é um espaço seguro e deve ser usado como caderno, não como banco de dados nem como hospedagem de arquivos.",
  "versao": "0.6",
  "geradoEm": "2026-10-02T20:02:17.652Z",
  "comoUsarEsteMapa": [
    "Cada item de \"secoes[].paginas\" tem \"url\" (página para pessoas) e \"textoPuro\" (Markdown limpo, ideal para agentes). Prefira \"textoPuro\".",
    "Comece por GET /api/v1/me com o token recebido para confirmar a conta e ver as permissões e os limites.",
    "Antes de escrever, leia \"regras\". Na dúvida, apenas leia e pergunte à pessoa."
  ],
  "documentacao": {
    "inicio": "https://wire.ia.br/documentation/",
    "indice": "https://wire.ia.br/documentation/llms.txt",
    "tudoEmTextoPuro": "https://wire.ia.br/documentation/llms-full.txt",
    "esteMapa": "https://wire.ia.br/documentation/agents/raw.json"
  },
  "api": {
    "base": "https://wire.ia.br/api/v1",
    "autenticacao": {
      "cabecalho": "Authorization: Bearer paper_<id de 8>_<segredo de 40>",
      "confirmacaoDeConta": "Opcional e recomendado: X-Paper-Account: <ID da conta, 32 caracteres>. Se não bater com o dono do token, a resposta é 403.",
      "ondeCriar": "App do Paper → Configurações → Desenvolvedor (precisa ligar o modo desenvolvedor)."
    },
    "tiposDeToken": {
      "seguro": "Para IA. Enxerga só uma cópia isolada de um cofre (id \"copia-<16 hex>\"). Mudanças ficam esperando a pessoa revisar e trazer para o cofre de verdade.",
      "normal": "Para automações. Alcança os cofres de verdade pelo Google Drive da pessoa, a agenda \"Paper\" e o envio de arquivos, conforme as permissões."
    },
    "limites": {
      "pedidosPorMinuto": 60,
      "pedidosPorDia": 5000,
      "enviosDeArquivoPorDia": 30,
      "tamanhoMaximoDeArquivo": "10 MB",
      "textoMaximoPorPagina": "1 MB",
      "tokensAtivosPorConta": 20
    },
    "endpoints": [
      {
        "metodo": "GET",
        "caminho": "/me",
        "para": "Conta, token, permissões e limites."
      },
      {
        "metodo": "GET",
        "caminho": "/vaults",
        "para": "Cofres que o token alcança (id, nome, acesso)."
      },
      {
        "metodo": "GET",
        "caminho": "/vaults/{cofre}/pages",
        "para": "Lista páginas e pastas (id, title, parentId, kind, updatedAt). Filtre com ?parent={id} ou ?parent= (raiz)."
      },
      {
        "metodo": "GET",
        "caminho": "/vaults/{cofre}/pages/{id}",
        "para": "Lê uma página: title e markdown. Use ?format=md para receber só o Markdown."
      },
      {
        "metodo": "POST",
        "caminho": "/vaults/{cofre}/pages",
        "para": "Cria página ou pasta.",
        "corpo": {
          "title": "texto",
          "markdown": "texto (opcional)",
          "parentId": "id da mãe (opcional)",
          "kind": "\"pagina\" (padrão) ou \"pasta\""
        },
        "permissao": "editar"
      },
      {
        "metodo": "PATCH",
        "caminho": "/vaults/{cofre}/pages/{id}",
        "para": "Muda título, troca o texto inteiro (markdown) ou acrescenta no fim (append).",
        "permissao": "editar"
      },
      {
        "metodo": "DELETE",
        "caminho": "/vaults/{cofre}/pages/{id}",
        "para": "Manda para a lixeira (dá para recuperar).",
        "permissao": "editar"
      },
      {
        "metodo": "GET",
        "caminho": "/vaults/{cofre}/search?q=",
        "para": "Busca no título e no texto."
      },
      {
        "metodo": "POST",
        "caminho": "/vaults/{cofre}/files?name=arquivo.ext",
        "para": "Envia um arquivo (corpo binário) para a pasta Anexos. Devolve o Markdown para pôr numa página.",
        "permissao": "anexos"
      },
      {
        "metodo": "GET",
        "caminho": "/calendar/events?from=&to=",
        "para": "Eventos da agenda \"Paper\".",
        "permissao": "agenda: ler"
      },
      {
        "metodo": "POST",
        "caminho": "/calendar/events",
        "para": "Cria evento.",
        "corpo": {
          "title": "texto",
          "date": "AAAA-MM-DD",
          "time": "HH:MM (opcional)",
          "durationMinutes": "número (opcional)",
          "description": "texto (opcional)"
        },
        "permissao": "agenda: editar"
      },
      {
        "metodo": "DELETE",
        "caminho": "/calendar/events/{id}",
        "para": "Apaga evento da agenda \"Paper\".",
        "permissao": "agenda: editar"
      }
    ],
    "erros": {
      "400": "Pedido incompleto ou inválido.",
      "401": "Token ausente, inválido, revogado ou vencido.",
      "403": "Sem permissão para isso (cofre, agenda, anexos), conta diferente ou modo desenvolvedor desligado. Conta banida também cai aqui.",
      "404": "Cofre ou página não encontrados (cofres precisam estar sincronizados com o Google Drive).",
      "409": "Falta conexão: Google ou agenda não liberados para a API no app.",
      "413": "Grande demais.",
      "423": "Página protegida por senha: nenhum token abre.",
      "429": "Limite atingido: espere e tente de novo, com intervalos crescentes.",
      "502": "O Google Drive ou a Agenda falhou: tente de novo mais tarde.",
      "formato": "{\"error\": \"mensagem em português\"}"
    },
    "formatoDasPaginas": "Markdown comum. Tabelas em Markdown; quadros, cronogramas e gráficos em blocos ```paper-kanban, ```paper-cronograma e ```paper-grafico; tarefas \"- [ ]\"; datas \"@AAAA-MM-DD HH:MM\"; ligações entre páginas [[Título]]; anexos ![nome](Anexos/ref).",
    "oQueNenhumTokenFaz": [
      "Abrir páginas protegidas por senha.",
      "Ler grupos (criptografados de ponta a ponta).",
      "Mexer na conta, sessões, amigos ou configurações."
    ]
  },
  "regras": {
    "pode": [
      "Ler, criar e editar notas onde a pessoa deu permissão.",
      "Organizar, resumir, revisar, transformar anotações em tarefas e datas.",
      "Enviar arquivos que fazem parte das notas da pessoa (fotos, PDFs), dentro dos limites."
    ],
    "naoPode": [
      "Usar o Paper como banco de dados, fila, cache ou armazenamento de dados de outros sistemas.",
      "Usar a API ou os links publicados para hospedar imagens ou arquivos para outros sites.",
      "Contornar limites (vários tokens, várias contas, pedidos em rajada).",
      "Consultar sem parar: no máximo uma checagem por minuto para saber se algo mudou.",
      "Publicar ou mandar spam, conteúdo ilegal ou dados pessoais de outras pessoas.",
      "Compartilhar o token publicamente ou guardá-lo em código aberto.",
      "Tentar abrir páginas protegidas, ler dados de outras contas ou atacar o serviço."
    ],
    "consequencia": "Violação leva a banimento permanente da conta, sem reversão automática. Só uma apelação aceita reverte.",
    "termos": "https://wire.ia.br/documentation/termos/termos-da-api",
    "apelacao": "https://wire.ia.br/apelacao/"
  },
  "linksPublicosDeNotas": {
    "oQueSao": "Páginas que a pessoa publicou por link. Não precisam de token.",
    "pagina": "https://wire.ia.br/s/{codigo}",
    "textoPuro": "https://wire.ia.br/s/{codigo}.md",
    "json": "https://wire.ia.br/s/{codigo}.json"
  },
  "futuro": [
    "Hospedagem de imagens na nuvem para o plano pago (ainda não existe)."
  ],
  "secoes": [
    {
      "id": "inicio",
      "titulo": "Início",
      "paraQueServe": "Visão geral do Paper e por onde começar.",
      "paginas": [
        {
          "titulo": "Documentação do Paper",
          "descricao": "Como usar o caderno, conectar outros aparelhos e dar acesso a programas e agentes de IA com tokens.",
          "url": "https://wire.ia.br/documentation/",
          "textoPuro": "https://wire.ia.br/documentation/raw/index.md"
        }
      ]
    },
    {
      "id": "guia",
      "titulo": "Guia de uso",
      "paraQueServe": "Como usar o app: escrever, organizar, cofres, pastas, compartilhar, grupos e privacidade. Útil para responder dúvidas de quem usa o Paper.",
      "paginas": [
        {
          "titulo": "Cofres, pastas e páginas",
          "descricao": "Três jeitos de organizar, do maior para o menor.",
          "url": "https://wire.ia.br/documentation/guia/cofres-pastas-e-paginas",
          "textoPuro": "https://wire.ia.br/documentation/raw/guia/cofres-pastas-e-paginas.md"
        },
        {
          "titulo": "Comece por aqui",
          "descricao": "Os primeiros dez minutos no Paper, passo a passo e sem termos técnicos.",
          "url": "https://wire.ia.br/documentation/guia/comece-por-aqui",
          "textoPuro": "https://wire.ia.br/documentation/raw/guia/comece-por-aqui.md"
        },
        {
          "titulo": "Compartilhar uma página",
          "descricao": "Links públicos de leitura, com versão em texto puro para IAs e programas.",
          "url": "https://wire.ia.br/documentation/guia/compartilhar",
          "textoPuro": "https://wire.ia.br/documentation/raw/guia/compartilhar.md"
        },
        {
          "titulo": "Escrever e ler",
          "descricao": "Blocos, modo edição, modo leitura, modelos e o menu de cada página.",
          "url": "https://wire.ia.br/documentation/guia/escrever-e-ler",
          "textoPuro": "https://wire.ia.br/documentation/raw/guia/escrever-e-ler.md"
        },
        {
          "titulo": "Grupos e amizades",
          "descricao": "Notas em equipe, criptografadas de ponta a ponta, com edição ao mesmo tempo.",
          "url": "https://wire.ia.br/documentation/guia/grupos",
          "textoPuro": "https://wire.ia.br/documentation/raw/guia/grupos.md"
        },
        {
          "titulo": "Importar arquivos .md",
          "descricao": "Traga notas em Markdown, pastas inteiras e arquivos .zip.",
          "url": "https://wire.ia.br/documentation/guia/importar",
          "textoPuro": "https://wire.ia.br/documentation/raw/guia/importar.md"
        },
        {
          "titulo": "Privacidade e segurança",
          "descricao": "Onde as notas ficam, o que o servidor enxerga e como trancar uma página.",
          "url": "https://wire.ia.br/documentation/guia/privacidade-e-seguranca",
          "textoPuro": "https://wire.ia.br/documentation/raw/guia/privacidade-e-seguranca.md"
        },
        {
          "titulo": "Sincronizar com o Google Drive",
          "descricao": "Conecte uma vez por aparelho e o Paper mantém o celular e o computador iguais.",
          "url": "https://wire.ia.br/documentation/guia/sincronizar",
          "textoPuro": "https://wire.ia.br/documentation/raw/guia/sincronizar.md"
        },
        {
          "titulo": "Vindo de outro app",
          "descricao": "Para quem usava Obsidian ou Notion. Como trazer as notas e onde cada coisa ficou.",
          "url": "https://wire.ia.br/documentation/guia/vindo-de-outros-apps",
          "textoPuro": "https://wire.ia.br/documentation/raw/guia/vindo-de-outros-apps.md"
        }
      ]
    },
    {
      "id": "api",
      "titulo": "API pessoal",
      "paraQueServe": "Tudo para programas e agentes de IA lerem e escreverem no caderno de uma pessoa com um token de acesso.",
      "paginas": [
        {
          "titulo": "Agenda",
          "descricao": "Ler, criar e apagar eventos na agenda \"Paper\" do Google Agenda.",
          "url": "https://wire.ia.br/documentation/api/agenda",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/agenda.md"
        },
        {
          "titulo": "Agentes de IA",
          "descricao": "Regras e roteiro para uma IA usar o caderno de alguém com cuidado.",
          "url": "https://wire.ia.br/documentation/api/agentes-de-ia",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/agentes-de-ia.md"
        },
        {
          "titulo": "Anexos",
          "descricao": "Enviar imagens e arquivos que fazem parte das notas.",
          "url": "https://wire.ia.br/documentation/api/anexos",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/anexos.md"
        },
        {
          "titulo": "Autenticação",
          "descricao": "O cabeçalho do token e a confirmação de conta com o ID.",
          "url": "https://wire.ia.br/documentation/api/autenticacao",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/autenticacao.md"
        },
        {
          "titulo": "Busca",
          "descricao": "Procurar páginas por título e texto dentro de um cofre.",
          "url": "https://wire.ia.br/documentation/api/busca",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/busca.md"
        },
        {
          "titulo": "Cofres e páginas",
          "descricao": "Listar cofres, listar e ler páginas, criar, editar e mandar para a lixeira.",
          "url": "https://wire.ia.br/documentation/api/cofres-e-paginas",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/cofres-e-paginas.md"
        },
        {
          "titulo": "Cópias para IA",
          "descricao": "Como funciona o token seguro, a cópia isolada de um cofre e a revisão das mudanças.",
          "url": "https://wire.ia.br/documentation/api/copias-para-ia",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/copias-para-ia.md"
        },
        {
          "titulo": "Erros",
          "descricao": "Os códigos de resposta e o que fazer com cada um.",
          "url": "https://wire.ia.br/documentation/api/erros",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/erros.md"
        },
        {
          "titulo": "Exemplos",
          "descricao": "Código pronto em curl, JavaScript e Python, do primeiro pedido a uma automação completa.",
          "url": "https://wire.ia.br/documentation/api/exemplos",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/exemplos.md"
        },
        {
          "titulo": "Formato das páginas",
          "descricao": "O Markdown que a API lê e escreve, com tabelas, quadros, cronogramas, gráficos, datas e links.",
          "url": "https://wire.ia.br/documentation/api/formato-das-paginas",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/formato-das-paginas.md"
        },
        {
          "titulo": "Limites",
          "descricao": "Quantos pedidos, quantos arquivos e de que tamanho.",
          "url": "https://wire.ia.br/documentation/api/limites",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/limites.md"
        },
        {
          "titulo": "Modo desenvolvedor",
          "descricao": "O interruptor que libera tokens, envio de arquivos, mudanças na agenda e automações remotas.",
          "url": "https://wire.ia.br/documentation/api/modo-desenvolvedor",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/modo-desenvolvedor.md"
        },
        {
          "titulo": "Tokens de acesso",
          "descricao": "Os dois tipos de token, as permissões de cada um e como guardar e revogar.",
          "url": "https://wire.ia.br/documentation/api/tokens",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/tokens.md"
        },
        {
          "titulo": "Visão geral da API",
          "descricao": "O que a API pessoal faz, para quem ela serve e o caminho mais curto até o primeiro pedido.",
          "url": "https://wire.ia.br/documentation/api/visao-geral",
          "textoPuro": "https://wire.ia.br/documentation/raw/api/visao-geral.md"
        }
      ]
    },
    {
      "id": "termos",
      "titulo": "Termos",
      "paraQueServe": "O que é permitido e proibido na API. Leia antes de agir: violações levam a banimento permanente.",
      "paginas": [
        {
          "titulo": "Banimento e apelação",
          "descricao": "Quando uma conta é banida, o que acontece com ela e como pedir revisão.",
          "url": "https://wire.ia.br/documentation/termos/banimento-e-apelacao",
          "textoPuro": "https://wire.ia.br/documentation/raw/termos/banimento-e-apelacao.md"
        },
        {
          "titulo": "Termos de uso da API",
          "descricao": "As regras que você aceita ao ligar o modo desenvolvedor. Versão de 2 de outubro de 2026.",
          "url": "https://wire.ia.br/documentation/termos/termos-da-api",
          "textoPuro": "https://wire.ia.br/documentation/raw/termos/termos-da-api.md"
        },
        {
          "titulo": "Uso justo",
          "descricao": "O Paper é um caderno. O que isso quer dizer na prática.",
          "url": "https://wire.ia.br/documentation/termos/uso-justo",
          "textoPuro": "https://wire.ia.br/documentation/raw/termos/uso-justo.md"
        }
      ]
    },
    {
      "id": "ajuda",
      "titulo": "Ajuda",
      "paraQueServe": "Suporte, apelação e novidades.",
      "paginas": [
        {
          "titulo": "Novidades",
          "descricao": "O que mudou em cada versão. Mudanças que afetam a API aparecem aqui primeiro.",
          "url": "https://wire.ia.br/documentation/ajuda/novidades",
          "textoPuro": "https://wire.ia.br/documentation/raw/ajuda/novidades.md"
        },
        {
          "titulo": "Suporte",
          "descricao": "Como falar com o Paper e o que mandar para a resposta vir mais rápido.",
          "url": "https://wire.ia.br/documentation/ajuda/suporte",
          "textoPuro": "https://wire.ia.br/documentation/raw/ajuda/suporte.md"
        }
      ]
    }
  ],
  "ajuda": {
    "suporte": "https://wire.ia.br/suporte/",
    "apelacao": "https://wire.ia.br/apelacao/",
    "privacidade": "https://wire.ia.br/privacidade/",
    "termosDeUso": "https://wire.ia.br/termos/",
    "contato": "contato.brennoleon@gmail.com",
    "responsavel": "Israel de Jesus Silva"
  }
}