고객 REST API
Adobe Commerce as a Cloud Service에서 새로운 고객 REST API를 사용하는 방법을 알아봅니다. 이 자습서는 API 솔루션을 효과적으로 통합 및 최적화하려는 설계자 및 개발자에게 적합합니다.
이 비디오는 누구의 것입니까?
- Adobe Commerce과의 통합 구축을 담당하는 백엔드 개발자
- Headless 상거래 구현을 위한 고객 관리 워크플로를 디자인하는 기술 설계자
비디오 콘텐츠
- 서버 간 자격 증명을 사용하여 Adobe IMS로 인증하여 API 요청에 대한 액세스 토큰을 얻습니다
- Commerce as a Cloud Service에 올바른 REST API 끝점 형식 사용
- 적절한 JSON 페이로드와 함께 POST 및 PUT 요청을 사용하여 프로그래밍 방식으로 고객 계정을 만들고 업데이트합니다
코드 샘플
시작하기 전에 Experience Cloud 및 Adobe Developer Console에서 필요한 모든 값을 수집합니다. 이러한 값을 준비하면 원활한 설정 프로세스가 보장됩니다.
NOTE
올바른 조직에서 작업하고 있는지 확인하십시오. 조직 선택 사항은 Experience Cloud 및 Developer Console 모두에서 볼 수 있는 인스턴스 및 환경에 영향을 줍니다.
인스턴스 세부 사항 - experience.adobe.com
인스턴스 세부 사항에는 인스턴스 ID, GraphQL 끝점, 자격 증명과 같은 것이 포함됩니다.
개발자 세부 사항 - https://developer.adobe.com/console/
Developer Console에서 클라이언트 ID, 클라이언트 암호 및 액세스 토큰을 포함한 API 자격 증명을 관리할 수 있습니다. 서버 간 인증 또는 네이티브 앱 인증과 같은 새 자격 증명 유형을 만들 수도 있습니다.
사전 요구 사항
항목
값
Where is this value
Instance ID
<instance_id>experience.adobe.com
REST Endpoint
<rest_endpoint>experience.adobe.com
Client ID
<client_id>developer.adobe.com/console
클라이언트 암호
<client_secret>developer.adobe.com/console
Step 1: Get Access Token (Server-to-Server Authentication)
IMPORTANT
The variables shown in this sample are not valid. Use the <client_id> and <client_secret> from your project credentials.
curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials&client_id=<client_id>&client_secret=<client_secret>&scope=openid,AdobeID,email,additional_info.projectedProductContext,profile,commerce.aco.ingestion,commerce.accs,org.read,additional_info.roles'
Sample Response:
{
"access_token": "eyJhbGciOiJSUzI1NiIs...",
"token_type": "bearer",
"expires_in": 86399
}
Step 2: Create a Customer
IMPORTANT
The URL provided in this sample is not valid. Use your REST base url. Exchange '<rest_endpoint>' with your URL. It looks similar to this
https://na1-sandbox.api.commerce.adobe.com/AbCYab34cdEfGHiJ27123.This endpoint does not have /rest/ as part of the URL. Including that leads to an error.
Endpoint: POST /V1/customers
curl -X POST \
"<rest_endpoint>/V1/customers" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-d '{
"customer": {
"email": "john.doe@example.com",
"firstname": "John",
"lastname": "Doe",
"store_id": 1,
"website_id": 1
},
"password": "TempPa55word!"
}'
응답:
{
"id": 5,
"group_id": 1,
"created_at": "2026-01-23 20:40:15",
"updated_at": "2026-01-23 20:40:15",
"created_in": "Default Store View",
"email": "john.doe@example.com",
"firstname": "John",
"lastname": "Doe",
"store_id": 1,
"website_id": 1,
"addresses": [],
"disable_auto_group_change": 0
}
Step 3: Update a Customer
IMPORTANT
이 샘플에 제공된 URL이 잘못되었습니다. REST 기본 URL을 사용합니다. URL로 '<rest_endpoint>'를 교환합니다. 이
https://na1-sandbox.api.commerce.adobe.com/AbCYab34cdEfGHiJ27123과(와) 비슷합니다.다음 예제의 5 숫자는 POST "id": 5,을(를) 사용하여 이전에 만든 고객의 ID입니다. 5을(를) 요청에서 반환된 ID로 변경하십시오.
끝점: PUT /V1/customers/{customerId}
curl -X PUT \
"<rest_endpoint>/V1/customers/5" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-d '{
"customer": {
"id": 5,
"email": "john.doe@example.com",
"firstname": "John",
"lastname": "Doe-Updated"
}
}'
응답:
{
"id": 5,
"group_id": 1,
"created_at": "2026-01-23 20:40:15",
"updated_at": "2026-01-23 20:40:30",
"created_in": "Default Store View",
"email": "john.doe@example.com",
"firstname": "John",
"lastname": "Doe-Updated",
"store_id": 1,
"website_id": 1,
"addresses": []
}
전체 스크립트(올인원)
IMPORTANT
이 샘플에 표시된 변수가 잘못되었습니다. 프로젝트 자격 증명에서 클라이언트 ID 및 클라이언트 암호를 사용합니다. REST 기본 URL을 사용합니다. experience.adobe.com에서 REST 끝점 URL로 '<rest_endpoint>'를 교환합니다. 이
https://na1-sandbox.api.commerce.adobe.com/AbCDefGHiJ1234567과(와) 비슷합니다.#!/bin/bash
# Configuration be sure to update these with your projects unique values
CLIENT_ID="<client_id>"
CLIENT_SECRET="<client_secret>"
REST_ENDPOINT="<rest_endpoint>"
# Step 1: Get Access Token
echo "Getting access token..."
ACCESS_TOKEN=$(curl -s -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d "grant_type=client_credentials&client_id=${CLIENT_ID}&client_secret=${CLIENT_SECRET}&scope=openid,AdobeID,email,additional_info.projectedProductContext,profile,commerce.aco.ingestion,commerce.accs,org.read,additional_info.roles" | jq -r '.access_token')
echo "Token obtained: ${ACCESS_TOKEN:0:50}..."
# Step 2: Create Customer
echo ""
echo "Creating customer..."
CREATE_RESPONSE=$(curl -s -X POST \
"${REST_ENDPOINT}/V1/customers" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-d '{
"customer": {
"email": "john.doe@example.com",
"firstname": "John",
"lastname": "Doe",
"store_id": 1,
"website_id": 1
},
"password": "TempPa55word!"
}')
echo "Create Response:"
echo "$CREATE_RESPONSE" | jq .
# Extract customer ID
CUSTOMER_ID=$(echo "$CREATE_RESPONSE" | jq -r '.id')
echo "Customer ID: $CUSTOMER_ID"
# Step 3: Update Customer
echo ""
echo "Updating customer..."
curl -s -X PUT \
"${REST_ENDPOINT}/V1/customers/${CUSTOMER_ID}" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-d "{
\"customer\": {
\"id\": ${CUSTOMER_ID},
\"email\": \"john.doe@example.com\",
\"firstname\": \"john\",
\"lastname\": \"Doe-Updated\"
}
}" | jq .
이 자습서에 대한 중요 참고 사항
- URL 경로:
https://<server>.api.commerce.adobe.com/<tenant-id>/V1/customers사용 — NOThttps://<host>/rest/<store-view-code>/V1/customers - 인증: 이 자습서에서는 서버 간(
client_credentials부여 유형)을 사용했습니다. - 필수 범위:
commerce.accs - 토큰 만료: 86400초(24시간)
참조
recommendation-more-help
commerce-learn-help-home