erp 0.6.17
Primo amministratore
Serve il token locale di questa macchina. Non c’è una password condivisa. L’identificativo dell’organizzazione viene dalla sessione.
erpIstruzioni dell’API
API di questa bozza
Non c’è un URL pubblico. Una chiamata usa l’host che serve questa bozza. Aprire questo pannello non crea un token.
La sessione è il cookie imma_session o un Bearer di sessione. I token agente sono rifiutati quando si scrivono clienti o magazzino. La salute non richiede sessione.
L’organizzazione viene dalla sessione. Un identificatore inviato dal client è ignorato.
Una sessione cookie che scrive deve inviare l’intestazione x-imma-request con valore 1. Un Bearer non la usa. GET non la richiede.
GET clienti richiede customers.read. POST richiede customers.write. POST magazzino richiede inventory.adjust, solo proprietario e amministrazione. La biblioteca richiede una sessione. Le capacità agente richiedono un token agente e restituiscono solo gli ambiti.
POST /api/v1/inventory ripete un conteggio con la stessa idempotencyKey e lo stesso contenuto. Una chiave riusata con altro contenuto risponde 409. Creare un cliente non ha chiave di idempotenza.
Il recupero accetta 3 richieste l’ora per un indirizzo e non dice se esiste. I lavori agente si fermano a 30 l’ora per quel token. Le altre route montate non hanno un limite HTTP.
Nessuna route montata registra o riceve avvisi. I controlli di firma stanno nel dominio server e questo pulsante non li apre.
Emettere un token di servizio e revocarlo richiede un proprietario o un amministratore autenticato e resta in quell’organizzazione. Questa intestazione non emette, non mostra e non revoca un token. La rotazione non è implementata.
POST /api/v1/agent/jobs è montato per un token agente con jobs.write. Il bearer di esempio è sintetico e non è una chiave viva. Questo pannello non crea un token.
GET /api/health· Controlla il database. Nessuna sessione. Nessuna stringa di connessione.GET /api/v1/health· Controlla il database e i flag spenti. Nessuna sessione.GET /api/v1/openapi· Documento macchina. Incompleto. Vedi il vuoto sopra.GET /api/v1/customers· Elenca i clienti dell’organizzazione della sessione.POST /api/v1/customers· Crea un cliente. Campi code e name. organizationId nel corpo è ignorato.POST /api/v1/inventory· Rettifica di conteggio. Campi warehouseId, productId, countedQty, date, idempotencyKey. Gli esempi sotto sono sintetici.GET /api/v1/library/search· Query q. Biblioteca fuori rete. Non è una norma operativa.GET /api/v1/library/citation· Query q e locale facoltativo. Senza citazione restituisce il codice di errore.GET /api/v1/library/coverage· Conteggi di copertura. Non è un nulla osta legale.GET /api/v1/agent/capabilities· Restituisce gli ambiti del token agente chiamante. Non ne crea uno.GET /api/v1/agent/jobs· Accoda un lavoro locale per un token agente con jobs.write. La quota è 30 l’ora. Un token di sessione è rifiutato.POST /api/v1/agent/jobs· Accoda un lavoro locale per un token agente con jobs.write. La quota è 30 l’ora. Un token di sessione è rifiutato.
Esempio sintetico. Non è una credenziale 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"}