erp 0.6.17 · /ko/entrar
erpAPI 안내
이 초안의 API
공개 기본 주소가 없습니다. 호출은 이 초안을 제공하는 호스트를 씁니다. 이 패널을 열어도 토큰은 생기지 않습니다.
세션은 imma_session 쿠키 또는 세션 Bearer입니다. 에이전트 토큰은 고객과 재고 쓰기에서 거부됩니다. 상태는 세션이 필요 없습니다.
조직은 세션에서 옵니다. 클라이언트가 보낸 조직 식별자는 무시됩니다.
쓰는 쿠키 세션은 x-imma-request 헤더 값 1을 보내야 합니다. Bearer는 그 헤더를 쓰지 않습니다. GET은 요구하지 않습니다.
고객 GET은 customers.read가 필요합니다. POST는 customers.write가 필요합니다. 재고 POST는 inventory.adjust가 필요하며 소유자와 관리만 가집니다. 서고는 세션이 필요합니다. 에이전트 능력은 에이전트 토큰이 필요하고 범위만 돌려줍니다.
POST /api/v1/inventory 는 같은 idempotencyKey 와 같은 내용이면 실사를 반복합니다. 다른 내용으로 다시 쓰면 409 입니다. 고객 만들기에는 멱등 키가 없습니다.
복구는 주소당 시간당 3요청을 받고 존재 여부를 말하지 않습니다. 에이전트 작업은 그 토큰으로 시간당 30에서 멈춥니다. 다른 마운트된 경로에는 HTTP 제한이 없습니다.
마운트된 경로 중 콜백을 등록하거나 받는 것은 없습니다. 서명 검사는 서버 도메인에 있고 이 단추는 그것을 열지 않습니다.
서비스 토큰 발급과 철회는 인증된 소유자나 관리자가 필요하며 그 조직 안에 남습니다. 이 머리글은 토큰을 발급하거나 보여 주거나 철회하지 않습니다. 회전은 구현되지 않았습니다.
POST /api/v1/agent/jobs 는 jobs.write 가 있는 에이전트 토큰용으로 마운트되어 있습니다. 예시 bearer 는 합성이며 실제 키가 아닙니다. 이 패널은 토큰을 만들지 않습니다.
GET /api/health· 데이터베이스를 확인합니다. 세션 없음. 연결 문자열 없음.GET /api/v1/health· 데이터베이스와 꺼진 표시를 확인합니다. 세션 없음.GET /api/v1/openapi· 기계 문서입니다. 불완전합니다. 위의 빈틈을 보세요.GET /api/v1/customers· 세션 조직의 고객을 나열합니다.POST /api/v1/customers· 고객을 만듭니다. 필드는 code 와 name 입니다. 본문의 organizationId 는 무시됩니다.POST /api/v1/inventory· 실사 조정입니다. 필드는 warehouseId, productId, countedQty, date, idempotencyKey 입니다. 아래 예는 합성입니다.GET /api/v1/library/search· 질의 q. 오프라인 서고. 운용 법령이 아닙니다.GET /api/v1/library/citation· 질의 q 와 선택적 locale. 인용이 없으면 오류 코드를 돌려줍니다.GET /api/v1/library/coverage· 범위 수치입니다. 법적 승인이 아닙니다.GET /api/v1/agent/capabilities· 호출한 에이전트 토큰의 범위를 돌려줍니다. 토큰을 만들지 않습니다.GET /api/v1/agent/jobs· jobs.write 가 있는 에이전트 토큰으로 로컬 작업을 넣습니다. 한도에 시간당 30입니다. 세션 토큰은 거부됩니다.POST /api/v1/agent/jobs· jobs.write 가 있는 에이전트 토큰으로 로컬 작업을 넣습니다. 한도에 시간당 30입니다. 세션 토큰은 거부됩니다.
합성 예시입니다. 실제 자격 증명이 아닙니다.
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"}