immaerp
API-Anleitung
API dieses Entwurfs
Es gibt keine öffentliche Basis-URL. Ein Aufruf nutzt den Host dieses Entwurfs. Dieses Panel erzeugt kein Token.
Die Sitzung ist das Cookie imma_session oder ein Sitzungs-Bearer. Agenten-Token werden bei Kunden- und Bestandsschreibzugriff abgelehnt. Gesundheit braucht keine Sitzung.
Die Organisation kommt aus der Sitzung. Eine vom Client gesendete Kennung wird ignoriert.
Eine Cookie-Sitzung, die schreibt, muss den Kopf x-imma-request mit dem Wert 1 senden. Ein Bearer nutzt ihn nicht. GET verlangt ihn nicht.
GET Kunden braucht customers.read. POST braucht customers.write. POST Bestand braucht inventory.adjust, nur Inhaber und Verwaltung. Die Bibliothek braucht eine Sitzung. Agentenfähigkeiten brauchen ein Agenten-Token und liefern nur Bereiche.
POST /api/v1/inventory wiederholt eine Zählung bei gleichem idempotencyKey und gleichem Inhalt. Ein wiederverwendeter Schlüssel mit anderem Inhalt antwortet 409. Kundenanlage hat keinen Idempotenzschlüssel.
Die Wiederherstellung erlaubt 3 Anfragen pro Stunde für eine Adresse und sagt nicht, ob sie existiert. Agentenaufträge stoppen bei 30 pro Stunde für dieses Token. Die anderen gemounteten Routen haben kein HTTP-Limit.
Keine gemountete Route registriert oder empfängt Rückrufe. Signaturprüfungen liegen in der Serverdomäne und dieser Knopf öffnet sie nicht.
Ein Dienst-Token ausstellen oder widerrufen erfordert einen angemeldeten Inhaber oder Verwalter und bleibt in dieser Organisation. Diese Kopfzeile stellt kein Token aus, zeigt keins und widerruft keins. Rotation ist nicht umgesetzt.
POST /api/v1/agent/jobs ist gemountet für ein Agenten-Token mit jobs.write. Der Beispiel-Bearer ist synthetisch und kein echter Schlüssel. Dieses Panel erzeugt kein Token.
GET /api/health· Prüft die Datenbank. Keine Sitzung. Keine Verbindungszeichenkette.GET /api/v1/health· Prüft die Datenbank und die ausgeschalteten Schalter. Keine Sitzung.GET /api/v1/openapi· Maschinendokument. Unvollständig. Siehe die Lücke oben.GET /api/v1/customers· Listet Kunden der Sitzungsorganisation.POST /api/v1/customers· Legt einen Kunden an. Felder code und name. organizationId im Körper wird ignoriert.POST /api/v1/inventory· Zählanpassung. Felder warehouseId, productId, countedQty, date, idempotencyKey. Die Beispiele unten sind synthetisch.GET /api/v1/library/search· Abfrage q. Bibliothek ohne Netz. Kein operatives Gesetz.GET /api/v1/library/citation· Abfrage q und optionales locale. Ohne Zitat kommt der Fehlercode.GET /api/v1/library/coverage· Abdeckungszahlen. Keine rechtliche Freigabe.GET /api/v1/agent/capabilities· Liefert die Bereiche des rufenden Agenten-Tokens. Erzeugt keins.GET /api/v1/agent/jobs· Stellt einen lokalen Auftrag für ein Agenten-Token mit jobs.write ein. Das Kontingent ist 30 pro Stunde. Ein Sitzungstoken wird abgelehnt.POST /api/v1/agent/jobs· Stellt einen lokalen Auftrag für ein Agenten-Token mit jobs.write ein. Das Kontingent ist 30 pro Stunde. Ein Sitzungstoken wird abgelehnt.
Synthetisches Beispiel. Kein echtes Geheimnis.
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"}