3. API 요청 유틸리티 함수 구현
Storefront API에 GraphQL 요청을 전송하기 위해서는 올바른 HTTP 헤더 정보와 상점 도메인, 발급받은 Storefront Access Token이 필요합니다. 이를 비동기로 처리할 요청 유틸리티를 구현합니다.
3.1. 기본 설정 및 요청 함수 구현
fetch API를 활용하여 GraphQL 엔드포인트로 JSON 데이터를 요청하는 재사용 가능한 함수를 작성합니다.
// 1. Shopify 상점의 기본 정보 설정
const SHOPIFY_DOMAIN = "example.myshopify.com"; // 실제 상점 도메인으로 교체
const STOREFRONT_API_VERSION = "2026-01"; // Storefront API 버전
const STOREFRONT_ACCESS_TOKEN = "00000000000000000000000000000000"; // 1단계에서 발급받은 토큰
// 2. 공통 GraphQL 요청 유틸리티 함수
async function storefrontRequest(query, variables = {}) {
const response = await fetch(
`https://${SHOPIFY_DOMAIN}/api/${STOREFRONT_API_VERSION}/graphql.json`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
"X-Shopify-Storefront-Access-Token": STOREFRONT_ACCESS_TOKEN,
},
body: JSON.stringify({ query, variables }),
}
);
const result = await response.json();
// 최상위 수준 에러 확인
if (result.errors) {
console.error("GraphQL 에러 발생:", result.errors);
throw new Error("Storefront GraphQL 오류가 발생했습니다.");
}
return result.data;
}