시작하기
빠른 시작
에이전트 키를 발급받고 첫 API 호출까지 약 5분이면 충분합니다. 아래 순서대로 진행하세요.
1. 에이전트 키 발급
Weighter Agent API는 wtr_ak_로 시작하는 에이전트 키로 인증합니다. 키는 계량소 소장(오너)이 소장 콘솔에 로그인해 발급합니다. 자세한 절차는 API 키 발급·관리 문서를 참고하세요.
키는 발급 직후 한 번만 표시됩니다
평문 키는 발급 응답에서 단 한 번만 확인할 수 있습니다. 안전한 비밀 저장소에 즉시 보관하세요. 분실 시 재발급이 필요합니다.
2. 내 키 정보 확인 (GET /me)
발급한 키가 정상 동작하는지 GET /agent/v1/me로 확인합니다. 이 엔드포인트는 별도 스코프가 필요 없습니다.
요청
curl -X GET 'https://api.weighter.shop/agent/v1/me' \
-H 'Authorization: Bearer wtr_ak_xxxxxxxxxxxxxxxxxxxxxxxx'정상 응답은 봉투(envelope)로 감싼 형태입니다.
응답
{
"success": true,
"data": {
"keyId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"stationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"scopes": ["read:station", "read:weighing"]
}
}3. 계량 이력 조회 (GET /weighing-records)
read:weighing 스코프가 있는 키라면 계량 기록을 조회할 수 있습니다. 최신 5건을 가져와 봅니다.
요청
curl -X GET 'https://api.weighter.shop/agent/v1/weighing-records?limit=5' \
-H 'Authorization: Bearer wtr_ak_xxxxxxxxxxxxxxxxxxxxxxxx'목록 응답은 data.items 배열과 페이지네이션 정보를 포함합니다. 각 필드는 API 레퍼런스에서 확인하세요.