데이터 스키마: 인증

dataTokenData 필수

응답 예제 · TokenData.

예제: {"access_token":"EXAMPLE_ACCESS_TOKEN","expires_at":"2026-01-01T12:00:00Z","expires_in":900,"rate_limits":{"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10},"token_type":"Bearer"}

metaContextPageMeta | ContextMeta | PageMeta | RequestMeta 필수

응답 메타데이터입니다.

예제: {"request_id":"example"}

추가 필드: 아니요

access_token문자열필수

Authorization: Bearer 헤더에 사용할 토큰입니다. 별도 예제를 실행하기 전에 SHOPENTLY_ACCESS_TOKEN을 설정하세요.

예제: "EXAMPLE_ACCESS_TOKEN"

expires_at문자열필수

UTC 기준 만료 시각입니다. 현재 접근 제한에 따라 그 전에 토큰이 차단될 수 있습니다.

format: "date-time"

예제: "2026-01-01T12:00:00Z"

expires_in정수선택 사항

발급 시점부터 900초, 즉 15분입니다. 요청을 보내도 유효 기간은 연장되지 않습니다.

기본값: 900예제: 900

rate_limitsTokenRateLimitsData 필수

Engine ≥ 4.143.0. 각 토큰 응답에는 발급 당시 스토어 정책의 data.rate_limits가 포함됩니다. 모든 키가 이 한도를 공유하며 새 토큰을 받아도 초기화되지 않습니다. 요금제 변경은 토큰 만료 전에 적용될 수 있습니다.

예제: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}

token_type문자열선택 사항

Bearer. 반환한 토큰에 사용하는 인증 방식입니다.

const: "Bearer"

기본값: "Bearer"예제: "Bearer"

추가 필드: 아니요

auth_per_minute정수필수

인증 실패를 포함한 분당 토큰 요청 수입니다.

minimum: 0maximum: 1000000

예제: 10

read_per_minute정수필수

분당 읽기 요청 수입니다.

minimum: 0maximum: 1000000

예제: 60

write_per_minute정수필수

분당 쓰기 요청 수입니다. 이 값은 쓰기 권한을 부여하지 않습니다.

minimum: 0maximum: 1000000

예제: 10

추가 필드: 아니요

추가 필드: 아니요