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