Kunden-REST-API
Erfahren Sie, wie Sie neue Kunden-REST-APIs in Adobe Commerce as a Cloud Service verwenden. Dieses Tutorial ist ideal für Architekten und Entwickler, die API-Lösungen effektiv integrieren und optimieren möchten.
Für wen ist dieses Video bestimmt?
- Backend-Entwickler, die für die Erstellung von Integrationen mit Adobe Commerce verantwortlich sind
- Technische Architekten entwerfen Workflows für das Kundenmanagement für Headless-Commerce-Implementierungen
Videoinhalt
- Authentifizierung bei Adobe IMS mithilfe von Server-zu-Server-Anmeldedaten, um ein Zugriffstoken für API-Anfragen zu erhalten
- Verwenden des richtigen REST-API-Endpunktformats für Commerce as a Cloud Service
- Programmgesteuertes Erstellen und Aktualisieren von Kundenkonten mithilfe von POST- und PUT-Anfragen mit geeigneten JSON-Payloads
Code-Beispiele
Bevor Sie beginnen, erfassen Sie alle erforderlichen Werte aus Experience Cloud und der Adobe Developer Console. Durch die Bereitstellung dieser Werte ist ein reibungsloser Einrichtungsprozess gewährleistet.
NOTE
Stellen Sie sicher, dass Sie in der richtigen Organisation arbeiten. Die Auswahl Ihres Unternehmens wirkt sich darauf aus, welche Instanzen und Umgebungen sowohl in Experience Cloud als auch in Developer Console sichtbar sind.
Details der Instanz - experience.adobe.com
Die Instanzdetails enthalten Dinge wie Ihre Instanz-ID, GraphQL-Endpunkte und Anmeldeinformationen.
Details für Entwickler - https://developer.adobe.com/console/
In der Developer Console verwalten Sie Ihre API-Anmeldeinformationen, einschließlich Client-IDs, Client-Geheimnissen und Zugriffstoken. Sie können auch neue Berechtigungstypen erstellen, z. B. Server-zu-Server- oder native App-Authentifizierung.
Voraussetzungen
Element
Wert
Wo dieser Wert ist
Instanz-ID
<instance_id>experience.adobe.com
REST-Endpunkt
<rest_endpoint>experience.adobe.com
Client-ID
<client_id>developer.adobe.com/console
Client-Geheimnis
<client_secret>developer.adobe.com/console
Schritt 1: Zugriffstoken abrufen (Server-zu-Server-Authentifizierung)
IMPORTANT
Die in diesem Beispiel angezeigten Variablen sind ungültig. Verwenden Sie die Felder <client_id> und <client_secret> aus Ihren Projektanmeldeinformationen.
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'
Beispielantwort:
{
"access_token": "eyJhbGciOiJSUzI1NiIs...",
"token_type": "bearer",
"expires_in": 86399
}
Schritt 2: Kunden erstellen
IMPORTANT
Die in diesem Beispiel angegebene URL ist ungültig. Verwenden Sie Ihre REST-Basis-URL. Austausch von "<rest_endpoint>" mit der URL. Es sieht in etwa so aus wie
https://na1-sandbox.api.commerce.adobe.com/AbCYab34cdEfGHiJ27123.Dieser Endpunkt hat /rest/ nicht als Teil der URL. Einschließlich , die zu einem Fehler führt.
Endpunkt: 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!"
}'
Antwort:
{
"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
}
Schritt 3: Kunden aktualisieren
IMPORTANT
Die in diesem Beispiel angegebene URL ist ungültig. Verwenden Sie Ihre REST-Basis-URL. Austausch von "<rest_endpoint>" mit der URL. Es sieht in etwa so aus wie
https://na1-sandbox.api.commerce.adobe.com/AbCYab34cdEfGHiJ27123.Die im folgenden Beispiel 5 Zahl ist die ID des zuvor erstellten Kunden, der die POST-"id": 5, verwendet. Stellen Sie sicher, dass Sie 5 ID ändern, die in Ihrer Anfrage zurückgegeben wurde.
Endpunkt: 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"
}
}'
Antwort:
{
"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": []
}
Vollständiges Skript (All-in-One)
IMPORTANT
Die in diesem Beispiel angezeigten Variablen sind ungültig. Verwenden Sie die Client-ID und das Client-Geheimnis aus Ihren Projekt-Anmeldeinformationen. Verwenden Sie Ihre REST-Basis-URL. Austausch von "<rest_endpoint>" mit Ihrer REST-Endpunkt-URL von experience.adobe.com. Es sieht in etwa so aus wie
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 .
Wichtige Hinweise zu diesem Tutorial
- URL Path: Verwenden Sie
https://<server>.api.commerce.adobe.com/<tenant-id>/V1/customers— NOThttps://<host>/rest/<store-view-code>/V1/customers - Authentifizierung: In diesem Tutorial wurde „Server-zu-Server“ (
client_credentialsGewährungstyp) verwendet - Erforderlicher Umfang:
commerce.accs - Token-Ablauf: 86400 Sekunden (24 Stunden)
Verweise
recommendation-more-help
commerce-learn-help-home