# Exemplos

Fonte: https://wire.ia.br/documentation/api/exemplos

> Código pronto em curl, JavaScript e Python, do primeiro pedido a uma automação completa.



Todos os exemplos leem o token e o ID da conta de variáveis de ambiente:

```bash
export PAPER_TOKEN="paper_…"
export PAPER_CONTA="3f2a…"
```

## Um cliente mínimo [#um-cliente-mínimo]

<Tabs items="['JavaScript', 'Python', 'curl']">
  <Tab value="JavaScript">
    ```js
    // Node 18+ ou navegador. Sem dependências.
    const BASE = 'https://wire.ia.br/api/v1';

    async function paper(path, { method = 'GET', body, tentativas = 4 } = {}) {
      for (let i = 0; ; i++) {
        const res = await fetch(BASE + path, {
          method,
          headers: {
            Authorization: `Bearer ${process.env.PAPER_TOKEN}`,
            'X-Paper-Account': process.env.PAPER_CONTA,
            ...(body ? { 'Content-Type': 'application/json' } : {}),
          },
          body: body ? JSON.stringify(body) : undefined,
        });
        if (res.ok) return res.status === 204 ? null : res.json();
        const { error } = await res.json().catch(() => ({ error: res.statusText }));
        const vale = [429, 500, 502, 503].includes(res.status) && i < tentativas;
        if (!vale) throw new Error(`${res.status}: ${error}`);
        await new Promise((r) => setTimeout(r, 2000 * 2 ** i));
      }
    }

    const eu = await paper('/me');
    console.log(`Conectado como ${eu.conta.nome}, token ${eu.token.tipo}`);
    ```
  </Tab>

  <Tab value="Python">
    ```python
    # Python 3.9+. Precisa de: pip install requests
    import os, time, requests

    BASE = "https://wire.ia.br/api/v1"
    SESSAO = requests.Session()
    SESSAO.headers.update({
        "Authorization": f"Bearer {os.environ['PAPER_TOKEN']}",
        "X-Paper-Account": os.environ["PAPER_CONTA"],
    })

    def paper(caminho, metodo="GET", json=None, tentativas=4):
        for i in range(tentativas + 1):
            res = SESSAO.request(metodo, BASE + caminho, json=json, timeout=30)
            if res.ok:
                return res.json() if res.content else None
            if res.status_code not in (429, 500, 502, 503) or i == tentativas:
                raise RuntimeError(f"{res.status_code}: {res.json().get('error')}")
            time.sleep(2 * 2 ** i)

    eu = paper("/me")
    print(f"Conectado como {eu['conta']['nome']}, token {eu['token']['tipo']}")
    ```
  </Tab>

  <Tab value="curl">
    ```bash
    paper() {
      curl -sS "https://wire.ia.br/api/v1$1" \
        -H "Authorization: Bearer $PAPER_TOKEN" \
        -H "X-Paper-Account: $PAPER_CONTA" \
        -H "Content-Type: application/json" "${@:2}"
    }

    paper /me
    paper /vaults
    ```
  </Tab>
</Tabs>

## Criar a página do dia [#criar-a-página-do-dia]

Cria uma página com a data de hoje numa pasta "Diário do script", se ela ainda não existir.

<Tabs items="['JavaScript', 'Python']">
  <Tab value="JavaScript">
    ```js
    const hoje = new Date().toISOString().slice(0, 10);
    const paginas = await paper('/vaults/principal/pages');

    let pasta = paginas.find((p) => p.kind === 'pasta' && p.title === 'Diário do script');
    if (!pasta) {
      pasta = await paper('/vaults/principal/pages', {
        method: 'POST',
        body: { title: 'Diário do script', kind: 'pasta' },
      });
    }

    if (!paginas.some((p) => p.parentId === pasta.id && p.title === hoje)) {
      await paper('/vaults/principal/pages', {
        method: 'POST',
        body: {
          title: hoje,
          parentId: pasta.id,
          markdown: `## Para hoje\n\n- [ ] \n\n## Anotações\n`,
        },
      });
    }
    ```
  </Tab>

  <Tab value="Python">
    ```python
    from datetime import date

    hoje = date.today().isoformat()
    paginas = paper("/vaults/principal/pages")

    pasta = next((p for p in paginas if p["kind"] == "pasta" and p["title"] == "Diário do script"), None)
    if pasta is None:
        pasta = paper("/vaults/principal/pages", "POST", {"title": "Diário do script", "kind": "pasta"})

    if not any(p["parentId"] == pasta["id"] and p["title"] == hoje for p in paginas):
        paper("/vaults/principal/pages", "POST", {
            "title": hoje,
            "parentId": pasta["id"],
            "markdown": "## Para hoje\n\n- [ ] \n\n## Anotações\n",
        })
    ```
  </Tab>
</Tabs>

## Acrescentar numa página [#acrescentar-numa-página]

```bash
paper /vaults/principal/pages/pa1k2m3n4o5p -X PATCH \
  -d '{"append": "- [ ] Ligar para o fornecedor @2026-10-07 10:00"}'
```

## Ler tudo de uma pasta para uma IA [#ler-tudo-de-uma-pasta-para-uma-ia]

```python
def texto_da_pasta(cofre, pasta_id):
    partes = []
    for p in paper(f"/vaults/{cofre}/pages?parent={pasta_id}"):
        if p["kind"] == "pagina" and not p.get("locked"):
            pagina = paper(f"/vaults/{cofre}/pages/{p['id']}")
            partes.append(f"# {pagina['title']}\n\n{pagina['markdown']}")
    return "\n\n---\n\n".join(partes)
```

Pastas com muitas páginas gastam um pedido por página. Para 60 páginas ou mais, espalhe as leituras ao longo de alguns minutos.

## Criar um evento a partir de uma tarefa [#criar-um-evento-a-partir-de-uma-tarefa]

```js
await paper('/calendar/events', {
  method: 'POST',
  body: { title: 'Ligar para o fornecedor', date: '2026-10-07', time: '10:00', durationMinutes: 15 },
});
```

## Enviar uma imagem e pôr numa página [#enviar-uma-imagem-e-pôr-numa-página]

```bash
RESPOSTA=$(curl -sS -X POST "https://wire.ia.br/api/v1/vaults/principal/files?name=grafico.png" \
  -H "Authorization: Bearer $PAPER_TOKEN" \
  -H "X-Paper-Account: $PAPER_CONTA" \
  -H "Content-Type: image/png" \
  --data-binary @grafico.png)

MD=$(echo "$RESPOSTA" | jq -r .markdown)
paper /vaults/principal/pages/pa1k2m3n4o5p -X PATCH -d "$(jq -n --arg md "$MD" '{append: $md}')"
```

## Ferramenta para um agente (Claude, OpenAI e outros) [#ferramenta-para-um-agente-claude-openai-e-outros]

Uma definição de ferramenta no formato JSON Schema, que a maioria dos modelos aceita:

```json
{
  "name": "paper_acrescentar",
  "description": "Acrescenta texto em Markdown no fim de uma página do caderno Paper da pessoa.",
  "input_schema": {
    "type": "object",
    "properties": {
      "cofre": { "type": "string", "description": "Id do cofre, de GET /vaults" },
      "pagina": { "type": "string", "description": "Id da página, de GET /vaults/{cofre}/pages" },
      "texto": { "type": "string", "description": "Markdown a acrescentar" }
    },
    "required": ["cofre", "pagina", "texto"]
  }
}
```

Na hora de executar, chame `PATCH /vaults/{cofre}/pages/{pagina}` com `{"append": texto}`.