Kundenliste abrufen

Beschreibung

Mit dieser Methode können Sie eine Liste aller im System hinterlegter Kunden abrufen.

Anfrage

Syntax

GET /v2/customer HTTP/1.1
Host: api.cobai.com
Date: Datum/Uhrzeit
Authorization: Signatur

Request-Parameter

state

Liefert nur Kunden mit einem bestimmten Status, z.B. http://api.cobai.com/v1/customer?state=new. Der Parameter ist optional, wenn er fehlt erhalten Sie eine Liste aller Kunden.

Verfügbare Stati:

Name Beschreibung
new Nur Neukunden. Ein Neukunde ist ein Kunde der sich über das Shopfrontend selbst registriert hat. Der Kunden behält diesen Status bis sie einen Wert für das Feld autoDeliveryMode gesetzt haben.

Bei Verwendung eines nicht definierten Status erhalten Sie als Antwort HTTP-Statuscode 400 Bad request.

Request-Header

Diese Methode benutzt zusätzlich zu den Standard-Requestheadern keine weiteren Header.

Request-Body

Diese Methode verwendet keinen Request-Body

Antwortdokument

Als Antwort auf die Anfrage erhalten sie ein Antwortdokument mit folgendem Inhalt:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<customerIdList xmlns:atom="http://www.w3.org/2005/atom">
    <customer>
        <uuid>fe81c542-0d72-41e6-af06-87e9cbefb070</uuid>
        <atom:link rel="self" href="http://api.cobai.com/v1/customer/fe81c542-0d72-41e6-af06-87e9cbefb070"/>
    </customer>
    <customer>
        <uuid>7aa82b32-c86a-441b-a339-65d59c34719c</uuid>
        <atom:link rel="self" href="http://api.cobai.com/v1/customer/7aa82b32-c86a-441b-a339-65d59c34719c"/>
    </customer>
 
    ...
 
 
    <customer>
        <uuid>1b99acd7-d851-4726-b67b-58c3eb059581</uuid>
        <atom:link rel="self" href="http://api.cobai.com/v1/customer/1b99acd7-d851-4726-b67b-58c3eb059581"/>
    </customer>
</customerIdList>