immaerp
API-instructies
API van dit concept
Er is geen openbare basis-URL. Een aanroep gebruikt de host van dit concept. Dit paneel maakt geen token.
De sessie is de cookie imma_session of een sessie-Bearer. Agenttokens worden geweigerd bij schrijven van klanten of voorraad. Gezondheid vraagt geen sessie.
De organisatie komt uit de sessie. Een door de client gestuurd id wordt genegeerd.
Een cookiesessie die schrijft moet de kop x-imma-request met waarde 1 sturen. Een Bearer gebruikt die niet. GET vereist hem niet.
GET klanten vereist customers.read. POST vereist customers.write. POST voorraad vereist inventory.adjust, alleen eigenaar en beheer. De bibliotheek vereist een sessie. Agentmogelijkheden vereisen een agenttoken en geven alleen bereiken.
POST /api/v1/inventory herhaalt een telling bij dezelfde idempotencyKey en dezelfde inhoud. Een hergebruikte sleutel met andere inhoud geeft 409. Een klant aanmaken heeft geen idempotentiesleutel.
Herstel staat 3 verzoeken per uur toe voor een adres en zegt niet of het bestaat. Agenttaken stoppen bij 30 per uur voor dat token. De andere gemounte routes hebben geen HTTP-limiet.
Geen gemounte route registreert of ontvangt callbacks. Handtekeningcontroles zitten in het serverdomein en deze knop opent ze niet.
Een servicetoken uitgeven of intrekken vereist een aangemelde eigenaar of beheerder en blijft in die organisatie. Deze kop geeft geen token uit, toont er geen en trekt er geen in. Rotatie is niet geïmplementeerd.
POST /api/v1/agent/jobs is gemount voor een agenttoken met jobs.write. De voorbeeld-bearer is synthetisch en geen echte sleutel. Dit paneel maakt geen token.
GET /api/health· Controleert de database. Geen sessie. Geen verbindingsreeks.GET /api/v1/health· Controleert de database en de uitgeschakelde vlaggen. Geen sessie.GET /api/v1/openapi· Machinedocument. Onvolledig. Zie de leemte hierboven.GET /api/v1/customers· Toont klanten van de sessieorganisatie.POST /api/v1/customers· Maakt een klant. Velden code en name. organizationId in de body wordt genegeerd.POST /api/v1/inventory· Tellingcorrectie. Velden warehouseId, productId, countedQty, date, idempotencyKey. De voorbeelden hieronder zijn synthetisch.GET /api/v1/library/search· Query q. Bibliotheek zonder net. Geen werkende wet.GET /api/v1/library/citation· Query q en optionele locale. Zonder citaat komt de foutcode.GET /api/v1/library/coverage· Dekkingsaantallen. Geen juridische vrijgave.GET /api/v1/agent/capabilities· Geeft de bereiken van het aanroepende agenttoken. Maakt er geen.GET /api/v1/agent/jobs· Zet een lokale taak in de wachtrij voor een agenttoken met jobs.write. Het quotum is 30 per uur. Een sessietoken wordt geweigerd.POST /api/v1/agent/jobs· Zet een lokale taak in de wachtrij voor een agenttoken met jobs.write. Het quotum is 30 per uur. Een sessietoken wordt geweigerd.
Synthetisch voorbeeld. Geen echte sleutel.
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"}