erp 0.6.17
Primeiro administrador
É preciso o token local desta máquina. Não há senha compartilhada. O identificador da organização vem da sessão.
erpInstruções da API
API deste rascunho
Não há URL pública. Uma chamada usa o host que serve este rascunho. Abrir este painel não cria um token.
A sessão é o cookie imma_session ou um Bearer de sessão. Tokens de agente são recusados ao escrever clientes ou estoque. A saúde não exige sessão.
A organização vem da sessão. Um identificador enviado pelo cliente é ignorado.
Uma sessão por cookie que escreve deve enviar o cabeçalho x-imma-request com valor 1. Um Bearer não usa esse cabeçalho. GET não o exige.
GET de clientes exige customers.read. POST exige customers.write. POST de estoque exige inventory.adjust, só de proprietário e administração. A biblioteca exige sessão. As capacidades do agente exigem um token de agente e devolvem só alcances.
POST /api/v1/inventory repete uma contagem com a mesma idempotencyKey e o mesmo conteúdo. Uma chave reusada com outro conteúdo responde 409. Criar cliente não tem chave de idempotência.
A recuperação aceita 3 pedidos por hora para um endereço e não diz se ele existe. Os trabalhos de agente param em 30 por hora para esse token. As outras rotas montadas não têm limite HTTP.
Nenhuma rota montada registra ou recebe avisos. As verificações de assinatura existem no domínio do servidor e este botão não as abre.
Emitir um token de serviço e revogá-lo exigem um proprietário ou administrador autenticado e ficam nessa organização. Este cabeçalho não emite, mostra nem revoga um token. A rotação não está implementada.
POST /api/v1/agent/jobs está montado para um token de agente com jobs.write. O bearer de exemplo é sintético e não é uma chave viva. Este painel não cria um token.
GET /api/health· Verifica a base. Sem sessão. Sem cadeia de conexão.GET /api/v1/health· Verifica a base e as bandeiras desligadas. Sem sessão.GET /api/v1/openapi· Documento de máquina. Incompleto. Veja a lacuna acima.GET /api/v1/customers· Lista os clientes da organização da sessão.POST /api/v1/customers· Cria um cliente. Campos code e name. organizationId do corpo é ignorado.POST /api/v1/inventory· Ajuste de contagem. Campos warehouseId, productId, countedQty, date, idempotencyKey. Os exemplos abaixo são sintéticos.GET /api/v1/library/search· Consulta q. Biblioteca sem rede. Não é um estatuto operativo.GET /api/v1/library/citation· Consulta q e locale opcional. Se não houver citação, devolve o código de erro.GET /api/v1/library/coverage· Contagens de cobertura. Não é um aval legal.GET /api/v1/agent/capabilities· Devolve os alcances do token de agente que chama. Não cria um.GET /api/v1/agent/jobs· Enfileira um trabalho local para um token de agente com jobs.write. A cota é 30 por hora. Um token de sessão é recusado.POST /api/v1/agent/jobs· Enfileira um trabalho local para um token de agente com jobs.write. A cota é 30 por hora. Um token de sessão é recusado.
Exemplo sintético. Não é uma credencial viva.
SYNTHETIC
Authorization: Bearer imma_sess_EXAMPLE
x-imma-request: 1
{"code":"C-EXAMPLE","name":"Example","organizationId":"ignored"}
{"warehouseId":"00000000-0000-0000-0000-000000000000","productId":"00000000-0000-0000-0000-000000000000","countedQty":"1","date":"2026-11-08","idempotencyKey":"example-count-1"}