immaerp
Istruzioni 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"}