Ansprechpartner eines Kunden auflisten

Liefert eine paginierte Liste der Ansprechpartner des angegebenen Kunden.

Verfügbarkeit: Nur Vollversion — eine Clock-Instanz antwortet auf diesen Endpunkt mit 404.

Request

GET /api/v1/customers/{customer_number}/contacts

curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/customers/{customer_number}/contacts' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Pfad-Parameter

Name
customer_number
Type
string
Description
Die Kundennummer des Kunden

Query-Parameter

Name
page
Type
integer, nullable
Description
Die zurückzugebende Ergebnisseite, beginnend bei 1.

Response

{
  "data": [
    {
      "id": 1,
      "first_name": "Erika",
      "last_name": "Mustermann",
      "salutation": "Frau",
      "title": "Dr.",
      "phone": "+49 30 12345678",
      "mobile": "+49 170 1234567",
      "fax": "+1-555-0124",
      "email": "erika.mustermann@acme-corp.de",
      "primary": true,
      "job_title": "Leiterin Einkauf",
      "department": "Einkauf",
      "language": "de",
      "inactive": false,
      "categories": [
        {
          "name": "EU",
          "description": {
            "de": "string",
            "en": "string",
            "fr": "string",
            "es": "string",
            "pl": "string"
          },
          "type": {
            "id": "string",
            "name": "Mitarbeiter/in"
          }
        }
      ]
    }
  ],
  "links": {
    "first": "string",
    "last": "string",
    "prev": "string",
    "next": "string"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": "string",
        "label": "string",
        "active": true
      }
    ],
    "path": "string",
    "per_page": 1,
    "to": 1,
    "total": 1
  }
}

Response-Felder

Name
id
Type
integer
Description
Eindeutige ID des Ansprechpartners.
Name
first_name
Type
string
Description
Vorname des Ansprechpartners.
Name
last_name
Type
string
Description
Nachname des Ansprechpartners.
Name
salutation
Type
string, nullable
Description
Anrede des Ansprechpartners (z. B. Herr/Frau), wird in der Korrespondenz verwendet.
Name
title
Type
string, nullable
Description
Akademischer Titel des Ansprechpartners (z. B. Dr.).
Name
phone
Type
string, nullable
Description
Telefonnummer des Ansprechpartners.
Name
mobile
Type
string, nullable
Description
Mobilnummer des Ansprechpartners.
Name
fax
Type
string, nullable
Description
Faxnummer des Ansprechpartners.
Name
email
Type
string, nullable
Description
E-Mail-Adresse des Ansprechpartners.
Name
primary
Type
boolean
Description
Ob dies der Hauptansprechpartner des Kunden ist.
Name
job_title
Type
string, nullable
Description
Position des Ansprechpartners beim Kunden.
Name
department
Type
string, nullable
Description
Freitext-Abteilungsname für diesen Ansprechpartner — ohne Bezug zum Abteilungsmodul.
Name
language
Type
string, nullable
Description
Bevorzugte Sprache des Ansprechpartners, wird für übersetzte Inhalte verwendet.
Name
inactive
Type
boolean
Description
Ob dieser Ansprechpartner inaktiv ist und nicht mehr aktiv verwendet wird.
Name
categories
Type
Liste von Category
Description
Die diesem Ansprechpartner zugeordneten Kategorien. Enthalten bei GET /customers/{customer}/contacts/{contact}, POST …/contacts und PUT …/contacts/{contact}; nicht enthalten beim Listen-Endpunkt GET /customers/{customer}/contacts.
Name
categories.name
Type
string
Description
Name der Kategorie, wird überall angezeigt, wo eine Entität damit gekennzeichnet ist.
Name
categories.description
Type
object
Description
Ausführlichere Erläuterung, wofür diese Kategorie verwendet werden soll.
Name
categories.type
Type
object
Description
Art der Entität, der diese Kategorie zugeordnet werden kann, z. B. Mitarbeiter, Projekt oder Kunde.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.

DELETE Kunde löschen POST Ansprechpartner anlegen