功能描述

APM 플랫폼의 상품 관리 API 모음. 관리자용 상품 추가/삭제/수정/가격·재고·할인 관리 17개 + 사용자용 상품 조회/검색/카테고리/추천/유사 상품/이미지 검색 16개, 총 33개 엔드포인트. 모든 엔드포인트는 먼저 ids_*_login으로 access_token 획득 후 a...

使用说明 (SKILL.md)

APM 상품 관리 API

Name: APM 상품 관리 API
Author: apmzoom

APM 플랫폼의 상품 관리 API 모음. 관리자용 상품 추가/삭제/수정/가격·재고·할인 관리 17개 + 사용자용 상품 조회/검색/카테고리/추천/유사 상품/이미지 검색 16개, 총 33개 엔드포인트. 모든 엔드포인트는 먼저 ids_*_login으로 access_token 획득 후 authcode 헤더(HH + token)로 호출. last_update_time 커서 페이지네이션 사용. 중국어/한국어 키워드 검색 지원.

공통 규약

Base URL: https://44k2t5n59e.execute-api.ap-northeast-2.amazonaws.com
요청 헤더: v=7.0.1, p=1, t=\x3Cunix초>, lang=zh-cn
인증 헤더: authcode: "HH " + access_token (로그인 계열 제외)
서명: sign = MD5(\x3Cparams> + \x3Csalt>).toUpperCase() — 엔드포인트별 salt는 각 문서 참조
성공 코드: code=100, 결과는 result 필드
페이지네이션: last_update_time 커서 방식, page_size=20

엔드포인트 목록 (33개)

gds_m_addgoods — 상품 정보 추가[판매자] · POST /gds/app/m_addgoods
gds_m_delgoods — 상품 정보 삭제[판매자] · GET /gds/app/m_delgoods
gds_m_editgoods — 상품 정보 수정[판매자] · POST /gds/app/m_editgoods
gds_m_editgoodsdiscount — 상품 할인 수정[판매자] · POST /gds/app/m_editgoodsdiscount
gds_m_editgoodsdiscountprice — 상품 할인 가격 수정[판매자] · POST /gds/app/m_editgoodsdiscountprice
gds_m_editgoodsprice — 상품 가격 수정[판매자] · POST /gds/app/m_editgoodsprice
gds_m_editgoodssell — 상품 진열 상태 수정[판매자] · POST /gds/app/m_editgoodssell
gds_m_editgoodsskuprice — 상품 규격 재고 가격 수정[판매자] · POST /gds/app/m_editgoodsskuprice
gds_m_editgoodsstock — 상품 재고 수정[판매자] · POST /gds/app/m_editgoodsstock
gds_m_goodsclassattributealllist — 상품 카테고리 속성 목록 조회[판매자] · GET /gds/app/m_goodsclassattributealllist
gds_m_goodsclasslist — 상품 카테고리 목록 조회[판매자] · GET /gds/app/m_goodsclasslist
gds_m_goodsclassspecalllist — 상품 카테고리 규격 목록 조회[판매자] · GET /gds/app/m_goodsclassspecalllist
gds_m_goodseditinfo — 상품 편집 상세 정보 조회[판매자] · GET /gds/app/m_goodseditinfo
gds_m_goodseditskuinfo — 상품 규격 정보 조회[판매자] · GET /gds/app/m_goodseditskuinfo
gds_m_goodsmakeaddresslist — 원산지 목록 조회[판매자] · GET /gds/app/m_goodsmakeaddresslist
gds_m_goodsskuiscandel — 상품 SKU 삭제 가능 여부 조회[판매자] · GET /gds/app/m_goodsskuiscandel
gds_m_storegoodslist — 판매자 상품 목록 조회 · GET /gds/app/m_storegoodslist
gds_u_addgoods — 상품 정보 추가[셀프 추가 결제] · POST /gds/app/u_addgoods
gds_u_categorygoodslist — 상품 카테고리별 상품 목록 조회[사용자] · GET /gds/app/u_categorygoodslist
gds_u_complaintgoodsprice — 상품 가격 신고[사용자] · POST /gds/app/u_complaintgoodsprice
gds_u_dategoodslist — 일자별 신상품 목록 조회[사용자] · GET /gds/app/u_dategoodslist
gds_u_datelist — 일자별 신상품 날짜 목록 조회[사용자] · GET /gds/app/u_datelist
gds_u_delgoods — 상품 정보 삭제[사용자] · POST /gds/app/u_delgoods
gds_u_goods — 상품 상세 조회[사용자] · GET /gds/app/u_goods
gds_u_goodsclasslist — 상품 카테고리 목록 조회[사용자] · GET /gds/app/u_goodsclasslist
gds_u_goodsclassspecalllist — 상품 카테고리 규격 목록 조회[사용자] · GET /gds/app/u_goodsclassspecalllist
gds_u_goodsskulist — 상품 규격 정보 조회[사용자] · GET /gds/app/u_goodsskulist
gds_u_imgsearchgoodslist — 이미지 상품 검색 목록[사용자] · POST /gds/app/u_imgsearchgoodslist
gds_u_recommendgoodslist — 상품 목록·범용[사용자] · GET /gds/app/u_recommendgoodslist
gds_u_searchgoodslist — 상품 검색 목록 조회[사용자] · GET /gds/app/u_searchgoodslist
gds_u_selfgoodslist — 셀프 추가 결제 상품 목록 · GET /gds/app/u_selfgoodslist
gds_u_similargoodslist — 유사 상품 목록 조회[사용자] · GET /gds/app/u_similargoodslist
gds_u_storegoodslist — 매장 상품 목록 조회[사용자] · GET /gds/app/u_storegoodslist

사용법

필요한 엔드포인트 문서를 확인 (파일명 = 엔드포인트 이름)
ids_*_login_* 중 하나로 access_token 획득 (APM_USER_TOKEN 환경변수에 저장)
요청 헤더에 authcode: "HH " + $APM_USER_TOKEN 추가
해당 문서의 서명 규칙에 따라 sign 계산 후 호출

원본 문서: https://github.com/apmzoom-ai/apm-skills

安全使用建议

This skill is an instruction-only API reference for an APM product-management back end and requires you to supply an access token in the APM_USER_TOKEN environment variable. Before installing or using it: (1) verify you trust the Base URL (https://44k2t5n59e.execute-api.ap-northeast-2.amazonaws.com) and the package homepage; (2) avoid placing long-lived or highly privileged credentials in a global environment variable — use a scoped/ephemeral token if possible; (3) confirm whether you need separate seller and user tokens (the docs mention both roles but only one env var is declared); (4) watch for the documented inconsistencies (e.g., gds_m_delgoods shows POST in the flow but lists GET in Quick Reference) and test calls with a non-production account first; and (5) consider limiting the token's permissions to the minimum needed (read-only for discovery, separate write token for changes) and monitoring activity on that token.

能力评估

ℹ Purpose & Capability

The name/description (APM 상품 관리 API) matches the documented endpoints: read/write product operations against a single API gateway. Requested items (just APM_USER_TOKEN) are plausible for an HTTP API client. One small mismatch: the docs reference separate login flows (ids_*_login for seller/user tokens) but the skill declares only a single primary environment variable (APM_USER_TOKEN) — it is unclear how seller vs user tokens should be managed.

⚠ Instruction Scope

Instructions tell the agent to call the external Base URL with an authcode header and to compute MD5-based signatures per-endpoint. That is expected for an API doc skill. Concerns: (1) the SKILL docs refer to performing 'ids_*_login' to acquire tokens but the login endpoints are not included in the package — the skill therefore expects a pre-provisioned token in the environment, which must be provided externally; (2) at least one endpoint file (gds_m_delgoods) contains an inconsistency: text describes a POST body but the Quick Reference lists Method: GET — this ambiguity could cause incorrect calls; (3) headers and signature scheme require constructing and transmitting the token ('HH ' + token) to an external host — nothing in the instructions attempts to read unrelated local files, but the agent will transmit whatever token is in APM_USER_TOKEN to the documented host.

✓ Install Mechanism

No install spec and no code files — instruction-only skill. This is low-risk in terms of installation because nothing is written to disk or downloaded.

ℹ Credentials

Only one environment variable (APM_USER_TOKEN) is requested, which is proportionate for an API client. However, the APIs include both seller (관리자) and user endpoints; the docs imply different login flows/roles but do not declare separate env vars for seller vs user tokens. That ambiguity increases the chance of accidentally providing a token with broader privileges than intended.

✓ Persistence & Privilege

The skill is not always-enabled and does not request system config paths or other privileges. It does not modify other skills' configurations. Autonomous invocation is allowed (default) but not flagged by itself.

版本历史

v1.0.0

Initial release: 33 goods management endpoints (merchant+user) for APM platform

元数据

Slug apmzoom-gds

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题