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>