연락처
2고객, 공급업체, 그리고 그들이 속한 세그먼트.
연락처연락처 세그먼트대부분의 비즈니스 소프트웨어는 제품별 API를 제공합니다. 계산대용, 재고용, 송장용 API가 각각 따로 있고, 인증 방식과 날짜 처리 방식도 제각각입니다. Kardopal은 단 하나의 API를 제공합니다. 동일한 키, 동일한 기본 URL, 동일한 쿼리 문법으로 29개 모듈의 129개 리소스에 접근할 수 있습니다.
여기서는 사실이지만 보통은 그렇지 않은 여섯 가지.
기본 URL에 접속하면 API가 자체 카탈로그를 반환합니다. 귀하의 키가 볼 수 있는 모든 모듈, 그 안에 있는 모든 리소스, 검색 가능한 필드와 필터링 가능한 필드를 보여줍니다. 통합을 작성하기 위해 이 페이지가 필요한 것이 아니라, 통합을 결정하기 위해 필요합니다.
앱의 범위, 경로 및 권한 필은 하나의 목록에서 생성되므로, 백엔드에 엔드포인트가 없으면 권한을 제공할 수 없습니다. 다음으로 범위가 지정된 키: 품목 항목을 가져옵니다 — 급여를 요청하면 조용한 빈 페이지가 아닌 403을 반환합니다.
검색, 이후, 까지, 건너뛰기 및 take 재고 이동과 마찬가지로 인보이스에서도 동일한 의미를 가집니다. 한 번만 익히면 133개의 모든 리소스에 적용됩니다.
모든 테이블은 테넌트 ID를 가지며, 모든 쿼리는 데이터베이스에 도달하기 전에 키 자체의 테넌트에 한정됩니다. 교차 테넌트 읽기는 잘못될 수 없는데, 이를 요청할 수 있는 매개변수가 없기 때문입니다.
필드 목록은 수동으로 관리하는 대신 부팅 시 라이브 스키마에서 읽어옵니다. 새 열은 자동으로 나타나고, 삭제된 열은 문서에 매달린 참조를 남기거나 첫 호출에서 500 오류를 발생시키지 않습니다.
키는 읽기 전용입니다. 쓰기 작업은 하지 않습니다. 잘못된 통합은 송장을 무효화하거나 재고를 이동시킬 수 없습니다. 기록을 변경하는 모든 작업은 앱 또는 직원 로그인을 통해 이루어지며, 이는 특정인에게 귀속되고 감사 로그에 기록됩니다.
모든 것이 GET 요청입니다. 만약 다음을 사용할 수 있다면 curl, 이를 사용할 수 있습니다.
/api/v1귀하의 키로 볼 수 있는 전체 카탈로그curl https://api.kardopal.com/api/v1 \
-H "X-API-Key: kp_live_…"
/api/v1/me유효성 검사 — 이 키는 누구의 것이며, 어떤 정보를 읽을 수 있습니까?{
"authType": "api_key",
"tenant": { "name": "Nova Retail", "plan": "pro" },
"scopes": ["items", "sales", "pos"]
}
/api/v1/items?search=lamp&take=2모든 리소스, 동일한 형태{
"resource": "items",
"scope": "items",
"total": 41,
"skip": 0,
"take": 2,
"hasMore": true,
"data": [ { "id": "…", "name": "Desk Lamp LED" } ]
}
/api/v1/meta/counts리소스별 행 수 — 어떤 데이터가 실제로 존재하는지 확인curl https://api.kardopal.com/api/v1/meta/counts \
-H "X-API-Key: kp_live_…"
| 매개변수 | 기능 | 메모 |
|---|---|---|
검색 | 리소스의 검색 가능한 필드 전체에서 대소문자 구분 없는 일치. | 해당 필드는 다음에서 나열됩니다. /메타 |
이후 | 이 날짜 이후의 기록만 | 리소스가 정렬하는 필드에 적용됩니다. |
까지 | 이 날짜까지의 기록만 | 결합 이후 창을 위한 |
건너뛰기 | 결과 세트 내 오프셋. | 기본값 0 |
take | 반환할 행 수 | 기본값 50, 최대 200 |
리소스는 자체 선언된 필드에 대해 정확히 일치하는 필터도 허용합니다 — ?status=paid, ?warehouseId=… — 그리고 각 응답은 어떤 것인지 알려줍니다. 모든 목록 응답에는 다음이 포함됩니다. 총계 및 더 보기, 따라서 페이징은 추측이 아닌 반복입니다.
29개 모듈, 129개 리소스. 각 카드는 키에 부여할 수 있는 하나의 권한이며, 회색 태그는 휴대폰 앱에 동일한 기록이 있는 곳입니다.
고객, 공급업체, 그리고 그들이 속한 세그먼트.
연락처연락처 세그먼트카탈로그: 제품, 품목, 브랜드, 가격표 및 단위.
품목카테고리브랜드품목 변형가격표단위+1개 더창고, 재고 수준, 이동, 배치, 일련번호 및 보관함.
창고재고 이동재고 현황배치일련 번호재고 집계+1개 더송장, 견적, 주문, 신용 메모 및 결제.
송장견적판매 주문신용 전표결제반복 송장+1개 더계산대, 교대 근무, 영수증, 테이블, 그리고 계산대를 거쳐간 모든 판매.
POS 판매POS 교대 근무POS 단말기POS 사용자POS 테이블POS 테이블 구역+5개 더리드, 거래, 파이프라인 및 제안.
잠재 고객딜파이프라인제안서구매 주문, 요청, 반품, 청구서 및 공급업체 결제.
구매 주문구매 요청구매 반품청구서공급업체 결제경비, 은행 계좌, 거래 및 세율.
경비비용 카테고리은행 계좌bank-transactions세율캠페인, 수신자, 랜딩 페이지 및 양식 제출.
캠페인캠페인 수신자랜딩 페이지양식 제출인사, 부서, 휴가, 급여 명세서, 근태 및 채용.
직원부서leave-requests급여 명세서근태채용 공고+2개 더시간 기록 및 해당 프로젝트.
시간 기록근무 시간표 프로젝트프로젝트, 단계 및 관련 비용.
프로젝트프로젝트 단계프로젝트 비용예약, 예약 가능한 서비스 및 서비스를 제공하는 직원.
예약예약 서비스예약 직원작업, 기술자, 작업 지시, 계약 및 장비.
현장 작업기술자서비스 요청서비스 계약work-orders작업 카드+1개 더배송, 운전자, 차량, 구역 및 운송업체.
배송드라이버차량배송 구역운송업체티켓, SLA 정책, 도움말 문서 및 지식 기반.
티켓고객 티켓도움말 문서지식 기반SLA 정책반품, 보증 청구, 수리 및 제품 등록.
RMAwarranty-claims보증 등록수리제품 등록임대 가능한 자산, 임대 계약 및 그 세부 내역.
자산대여렌탈 라인메뉴와 그에 따라 접수된 주문.
메뉴 항목메뉴 주문티켓, 서비스, 카운터, 지점, 그리고 디스플레이 화면.
대기표대기열 서비스대기열 카운터대기열 지점대기열 디스플레이회원, 계정, 등급, 보상 및 포인트 거래.
loyalty-members로열티 계정로열티 보상로열티 등급로열티 거래loyalty-coupons사이트 및 지점.
지점지점기기, 사이트, 박스, 알림, 이벤트 및 간판 콘텐츠.
IoT 장치iot-sitesIoT 알림IoT 이벤트IoT 박스IoT 사이니지 콘텐츠생성된 자산, 관련 프로젝트, 작업 이력.
AI 자산AI 프로젝트ai-jobs네트워크 회원, 견적 요청 및 수금.
네트워크 회원견적 요청컬렉션서명 요청 및 이에 따라 수집된 서명
서명 요청서명승인 요청 및 라우팅 규칙.
승인 요청승인 규칙업로드된 파일 및 스캔된 문서.
파일스캔 문서활동 피드, 감사 로그 및 알림.
활동감사 로그알림이것은 일반적으로 사실이 아닌 부분입니다. 많은 플랫폼이 광범위한 API를 공개하고 승인, 보기, 알림 세 가지 기능만 수행하는 모바일 앱을 제공합니다. Kardopal의 앱은 보조 도구가 아닌 제품 그 자체입니다. 위에 언급된 29개 모듈 모두 실제 화면을 가지고 있으며, 대부분의 작업이 휴대폰에서 실제로 이루어집니다.
품목. 필요하지 않습니다. hr. 좁은 키는 안전하게 실패합니다.X-API-Key: kp_live_… — 쿼리 문자열은 로그, 프록시 및 브라우저 기록에 남습니다.API는 자체적으로 문서화됩니다: 앱에서 키를 생성하고, 가리킵니다. curl 기본 URL에서, 해당 키가 접근할 수 있는 모든 모듈, 리소스 및 검색 가능한 필드를 반환합니다.