자료실
커머스·소통APIofficial

Shopify Admin GraphQL API

Shopify 상품·주문·고객·재고를 관리하는 공식 Admin GraphQL API

자료 등록 2026년 3월 28일

한눈에 보기

공식 검증 2026년 8월 29일

프로토콜
GraphQL · JSON
인증
Admin API access token · OAuth
비용
Shopify 플랜·앱 운영 비용
제공 상태
정식 제공 · 버전 정책 적용
공식 빠른 시작공식 빠른 시작 · https://shopify.dev/docs/api/admin-graphql/latest

Use cases

이럴 때 이렇게 연결합니다

먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.

추천 구성 · Situation 01

상품·재고·주문 상태를 관리자 화면마다 확인해 품절과 처리 지연을 늦게 발견하는 업무

어떤 어려움인가
Shopify 상품과 주문을 운영하는 커머스팀이 자주 마주치는 문제입니다. 구체적으로는 '상품·재고·주문 상태를 관리자 화면마다 확인해 품절과 처리 지연을 늦게 발견하는 업무' 상황입니다.
이렇게 해결합니다
Shopify Admin GraphQL API 단계에서는 요청과 응답 필드를 작은 범위로 맞춥니다. 입력 범위는 '상품 ID, 재고 위치, 주문 상태, 조회 기간'입니다. 필요한 필드만 골라 '재고 위험과 미처리 주문이 함께 정리된 운영표' 형태로 정리합니다.
왜 연결하는가
처음에는 Shopify Admin GraphQL API 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
마지막 확인
검토 대상은 '재고 위험과 미처리 주문이 함께 정리된 운영표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
Sequence입력부터 검토 결과까지
  1. 01 · 입력작은 입력 범위상품 ID, 재고 위치, 주문 상태, 조회 기간
    업무 조건
  2. 02 · 현재 자료Shopify Admin GraphQL APIAPI 요청: 입력 범위는 '상품 ID, 재고 위치, 주문 상태, 조회 기간'입니다. 필요한 필드만 골라 '재고 위험과 미처리 주문이 함께 정리된 운영표' 형태로 정리합니다.
    처리 결과
  3. 03 · 사람 확인담당자 검토검토 대상은 '재고 위험과 미처리 주문이 함께 정리된 운영표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.
    확인 완료
  4. 04 · 결과검토용 결과재고 위험과 미처리 주문이 함께 정리된 운영표

Result

이 흐름으로 남는 값

첫 요청

curl https://YOUR_STORE.myshopify.com/admin/api/YOUR_API_VERSION/graphql.json -H "X-Shopify-Access-Token: YOUR_SHOPIFY_TOKEN" -H "Content-Type: application/json" -d '{"query":"{ shop { name } }"}'

무엇이고 왜 필요한가

Shopify Admin GraphQL API는 상품·재고·주문·고객·할인 같은 스토어 관리 데이터를 필요한 필드만 질의하는 공식 API입니다. REST Admin API의 신규 앱 경로가 축소된 상황에서 최신 관리 연동의 기준이 됩니다.

할 수 있는 일

  • 상품·주문·고객·재고 데이터를 필요한 필드만 조회합니다.
  • 관리 작업과 웹훅 기반 앱을 구축합니다.

시작 전 확인

  • 앱 유형과 Admin API 접근 범위, 대상 스토어 설치를 준비합니다.
  • 인증·비용 조건은 Admin API access token · OAuth, Shopify 플랜·앱 운영 비용이며 제공 상태는 정식 제공 · 버전 정책 적용입니다.
  • 첫 요청은 공식 샘플과 테스트 자격으로 실행해 정상 응답·오류·호출 제한을 함께 확인합니다.

잘 맞는 경우

  • Shopify 스토어 운영 자동화와 커머스 앱 개발.

주의점

  • API 버전과 쿼리 비용 한도를 고정하고 개인정보 보호 요구를 적용합니다.
  • API 키는 브라우저 코드나 공개 예제에 넣지 않고 서버 비밀값으로 보관하며, 호출 실패·재시도·사용량을 기록합니다.

댓글 0

아직 댓글이 없습니다. 첫 댓글을 남겨보세요.

문의하기