Axuz Developers

POST /me/time/manual

Cria uma entry retroativa fechada (mode=manual) com validação de janela (started_at < ended_at, ≤ 24h).

  • Acesso: Login
  • Serviço: https://api.axuz.net

Autenticação aceita

  • sessionCookie — Sessão plena Axuz (cookie de sessão da casa). Sessão restrita é 403 enrollment_required.
  • bearerSession — JWT de acesso da sessão em `Authorization: Bearer`.
  • personalToken — Token pessoal (`axp_...`) criado em `POST /me/api-tokens`; escopo do próprio usuário.

Entradas: JSON {task_kind, task_id, started_at, ended_at, note?} + userID (JWT).

Retorno: 201 com TimeEntry; 400 body/kind/id inválido, timestamps ausentes ou inconsistentes, janela > 24h; 401 sem auth; 404 tarefa de time fora dos times do usuário; 503 livro indisponível.

Parâmetros

Sem parâmetros.

Corpo da requisição

Corpo JSON. O schema detalhado deste endpoint ainda não está tipado na spec; veja a descrição da operação.

application/json

NomeTipoObrigatórioDescrição
(corpo)objectnão
{}

Respostas

200

TBD

400

Body/kind/id inválido, timestamps ausentes ou inconsistentes, janela > 24h

NomeTipoObrigatórioDescrição
errorstringsim

401

Sem credencial valida

NomeTipoObrigatórioDescrição
errorstringsim

404

Tarefa de time fora dos times do usuário

NomeTipoObrigatórioDescrição
errorstringsim

429

Limite de requisições excedido.

NomeTipoObrigatórioDescrição
errorstringsim

500

Erro interno. Tente de novo com backoff; reporte o X-Request-Id.

NomeTipoObrigatórioDescrição
errorstringsim

503

Livro indisponível

NomeTipoObrigatórioDescrição
errorstringsim

Exemplos

O "Try it" está desligado nesta referência. Use os exemplos com a sua credencial de teste.

curl

curl -sS -X POST 'https://api.axuz.net/me/time/manual' \
  -H "Authorization: Bearer $AXUZ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

const res = await fetch("https://api.axuz.net/me/time/manual", {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AXUZ_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
console.log(await res.json());

Python

import os
import requests

res = requests.request(
    "POST",
    "https://api.axuz.net/me/time/manual",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    json={},
    timeout=30,
)
res.raise_for_status()
print(res.json())