DocumentatieCommerceVideo's en zelfstudies

REST-API voor klanten

Laatst bijgewerkt: 9 mei 2026

Gemaakt voor:

  • Beginner
  • Developer

Leer nieuwe REST-API’s voor klanten te gebruiken in Adobe Commerce as a Cloud Service. Deze zelfstudie is ideaal voor architecten en ontwikkelaars die API-oplossingen willen integreren en optimaliseren.

Voor wie is deze video?

  • Achterste ontwikkelaars die verantwoordelijk zijn voor de opbouw van integratie met Adobe Commerce
  • Technische architecten die de werkschema’s van het klantenbeheer voor headless handelsimplementaties ontwerpen

Video-inhoud

  • Verificatie met Adobe IMS waarbij server-naar-server referenties worden gebruikt voor het verkrijgen van een toegangstoken voor API-aanvragen
  • De juiste REST API-eindpuntnotatie gebruiken voor Commerce as a Cloud Service
  • Klantenaccounts programmatisch maken en bijwerken met POST- en PUT-verzoeken met de juiste JSON-payloads
https://video.tv.adobe.com/v/3479368?captions=dut&learn=on
https://video.tv.adobe.com/vc/3479368/dut.json

Codevoorbeelden

Alvorens te beginnen, verzamel alle vereiste waarden van ​ Experience Cloud ​ en ​ Adobe Developer Console ​. Als u deze waarden klaar hebt, bent u verzekerd van een vloeiend installatieproces.

NOTE
Zorg ervoor u in de correcte organisatie werkt. De selectie van uw organisatie bepaalt welke instanties en omgevingen zichtbaar zijn in zowel Experience Cloud als Developer Console.

Instantiedetails - experience.adobe.com

De instantiedetails bevatten dingen als uw Instantie-id, GraphQL-eindpunten, referenties.

Details ontwikkelaar - https://developer.adobe.com/console/

In Developer Console beheert u uw API-referenties, waaronder client-id’s, clientgeheimen en toegangstokens. U kunt ook nieuwe referentietypen maken, zoals Server-naar-server of Native App-verificatie.

Vereisten

Item
Waarde
Waar is deze waarde?
Instantie-id
<instance_id>
experience.adobe.com
REST Endpoint
<rest_endpoint>
experience.adobe.com
Client-id
<client_id>
developer.adobe.com/console
Clientgeheim
<client_secret>
developer.adobe.com/console

Stap 1: Get Token van de Toegang (server-aan-server Authentificatie)

IMPORTANT
De variabelen in dit voorbeeld zijn niet geldig. Gebruik de <client_id> en <client_geheime> op basis van uw projectreferenties.
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'

Antwoord van de Steekproef:

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "bearer",
  "expires_in": 86399
}

Stap 2: Een klant maken

IMPORTANT
De URL in dit voorbeeld is niet geldig. Gebruik de URL van de REST-basis. Uitwisseling '<rest_eindpunt>' met uw URL. Het ziet er ongeveer zo uit als https://na1-sandbox.api.commerce.adobe.com/AbCYab34cdEfGHiJ27123 .
Dit eindpunt heeft /rest/ als deel van URL niet. Als dit wordt opgenomen, treedt er een fout op.

Eindpunt: 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!"
  }'

Reactie:

{
  "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
}

Stap 3: Een klant bijwerken

IMPORTANT
De URL in dit voorbeeld is niet geldig. Gebruik de URL van de REST-basis. Uitwisseling '<rest_eindpunt>' met uw URL. Het ziet er ongeveer zo uit als https://na1-sandbox.api.commerce.adobe.com/AbCYab34cdEfGHiJ27123 .

Het getal 5 in het volgende voorbeeld is de id van de eerder gemaakte klant met POST "id": 5, . Ben zeker om 5 in om het even welke identiteitskaart te veranderen in uw verzoek werd teruggekeerd.

Eindpunt: 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"
    }
  }'

Reactie:

{
  "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": []
}

Volledig script (alles-in-één)

IMPORTANT
De variabelen in dit voorbeeld zijn niet geldig. Gebruik de client-id en het clientgeheim van uw projectreferenties. Gebruik de URL van de REST-basis. Uitwisseling '<rest_eindpunt>' met uw REST eindpunt URL van experience.adobe.com. Het ziet er ongeveer zo uit als 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 .

Belangrijke opmerkingen over deze zelfstudie

  1. Weg URL: Gebruik https://<server>.api.commerce.adobe.com/<tenant-id>/V1/customers — NIET https://<host>/rest/<store-view-code>/V1/customers
  2. Authentificatie: Dit leerprogramma gebruikte Server-aan-Server (client_credentials subsidietype)
  3. Vereiste Reikwijdte: commerce.accs
  4. Symbolische Verval: 86400 seconden (24 uren)

Verwijzingen

recommendation-more-help
commerce-learn-help-home