Der Endpunkt inquiries/ ermöglicht es, Anfrage-Daten abzufragen sowie zu löschen und ihren Status zu aktualisieren.

Inhaltsverzeichnis

1 1. Unterstützte Methoden
2 2. Datenfelder
3 3. Verwendung der Methoden
- 3.1 3.1 GET inquiries
- 3.2 3.2 GET inquiries/{inquiryId}
- 3.3 3.3 GET inquiries/open
- 3.4 3.4 PUT inquiries/{inquiryId}
- 3.5 3.5 DELETE inquiries/{inquiryId}
4 4. Support

1. Unterstützte Methoden

Angabe aller unterstützten Methoden.

Befehl/Info	Endpunkte	GET	POST	PUT	DELETE

Befehl/Info	Endpunkte	GET	POST	PUT	DELETE
Anfragen	inquiries/

2. Datenfelder

Name	Typ	Bedeutung

Name	Typ	Bedeutung
subshopId	String	Angabe des Subshops, in dem die Anfrage eingegangen ist (z. B. „deutsch“)
processingStatus	INT	Bearbeitungsstatus der Anfrage: `0` = New (neu eingegangen) `1` = Read (gelesen) `2` = Answered (beantwortet) `3` = Closed (abgeschlossen)
data	String (JSON)	Enthält Formularfelder und zusätzliche Meta-Daten der Anfrage, als JSON-String gespeichert
data.fields	Array	Enthält den technischen Namen des Feldes, sein Label (Bezeichnung) und den übergebenen Wert
data.inquiryConfigId	String	ID der Konfiguration, über die das Anfrageformular erstellt wurde
data.inquiryId	String	Eindeutige ID der Anfrage
data.shopId	String	Technischer Name des Shops
data.submitter	Objekt	Enthalt die Email-Adresse, die IP-Adresse und die ID der Session des Einsenders
data.subshopId	String	Angabe des Subshops, in dem die Anfrage eingegangen ist (z. B. „deutsch“)
createdAt	String	Datum und Uhrzeit der Erstellung der Anfrage (im ISO 8601-Format, UTC)
updatedAt	String	Datum und Uhrzeit der letzten Änderung der Anfrage (im ISO 8601-Format, UTC)

Beispiel:

{
    "createdAt": "2024-10-11T12:03:48Z",
    "data": {
        "fields": [
            {
                "label": "Vorname",
                "name": "firstName",
                "value": "Foo"
            },
            {
                "label": "Nachname",
                "name": "lastName",
                "value": "Bar"
            },
            {
                "label": "Betreff",
                "name": "subject",
                "value": "mySubject"
            },
            {
                "label": "Kundennummer",
                "name": "customerNumber",
                "value": "11"
            },
            {
                "label": "Text",
                "name": "text",
                "value": "myMessage"
            }
        ],
        "inquiryConfigId": "contact",
        "inquiryId": "4dea07ff679aa8b4",
        "shopId": "myshop",
        "submitter": {
            "emailAddress": "email@email.com",
            "ipAddress": "172.18.0.XXX",
            "sessionId": "cf41e72fadae3eaeb0aeca63d..."
        },
        "subshopId": "deutsch"
    },
    "id": "4dea07ff679aa8b4",
    "processingStatus": 0,
    "subshopId": "deutsch",
    "updatedAt": "2024-10-11T12:03:48Z"
}

3. Verwendung der Methoden

3.1 GET inquiries

Ruft eine Liste aller vorhandenen Anfragen ab – mit Filter- und Sortiermöglichkeiten.

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/inquiries

Antwort:

{
    "endReached": true,
    "items": [
        {
            "createdAt": "2024-10-11T12:03:48Z",
            "data": "{\"fields\":[{\"label\":\"Vorname\",\"name\":\"firstName\" ...",
            "id": "4dea07ff679aa8b4",
            "processingStatus": 0,
            "subshopId": "deutsch",
            "updatedAt": "2024-10-11T12:03:48Z"
        },
        ...
    ],
    "nextPageToken": "NQ",
    "totalCount": 6
}

Filterfelder:

createdAt, updatedAt, id, subshopId, processingStatus

Sortierfelder:

createdAt, updatedAt, id, subshopId, processingStatus

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Lesen von Anfragen.
400 Bad Request	"invalidValue"	`size` ∉ [1;300] \| `sort` ∉ {"asc", "desc"} \| `pageToken` ist keine Zahl oder kleiner als 0.
400 Bad Request	"unknownDataField"	Ein Filter- oder Sortierfeld ist ungültig.
400 Bad Request	"unknownOperation"	Ein Filtertyp ist ungültig.
400 Bad Request	"invalidCharacters"	`size` ist keine Ganzzahl. \| Ein Filterwert ist ungültig.
400 Bad Request	"syntaxError"	`sort` enthält mehr als einen oder keinen ":".
503 Service Unavailable	"internalError"	Nicht alle Anfragen konnten entschlüsselt werden.

3.2 GET inquiries/{inquiryId}

Ruft die Details einer einzelnen Anfrage anhand ihrer ID ab.

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/inquiries/4dea07ff679aa8b4

Antwort:

{
    "createdAt": "2024-10-11T12:03:48Z",
    "data": {
        "fields": [
            {
                "label": "Vorname",
                "name": "firstName",
                "value": "Foo"
            },
            {
                "label": "Nachname",
                "name": "lastName",
                "value": "Bar"
            },
            {
                "label": "Betreff",
                "name": "subject",
                "value": "mySubject"
            },
            {
                "label": "Kundennummer",
                "name": "customerNumber",
                "value": "11"
            },
            {
                "label": "Text",
                "name": "text",
                "value": "myMessage"
            }
        ],
        "inquiryConfigId": "contact",
        "inquiryId": "4dea07ff679aa8b4",
        "shopId": "myshop",
        "submitter": {
            "emailAddress": "email@email.com",
            "ipAddress": "172.18.0.XXX",
            "sessionId": "cf41e72fadae3eaeb0aeca63d..."
        },
        "subshopId": "deutsch"
    },
    "id": "4dea07ff679aa8b4",
    "processingStatus": 0,
    "subshopId": "deutsch",
    "updatedAt": "2024-10-11T12:03:48Z"
}

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Lesen von Anfragen.
404 Not Found		Die Anfrage wurde nicht gefunden.
503 Service Unavailable	"internalError"	Die Anfrage konnte nicht entschlüsselt werden.

3.3 GET inquiries/open

Dieser Endpunkt liefert eine Übersicht über die Anzahl offener Anfragen, gruppiert nach Anfragekonfigurationen. Die Antwort enthält eine Liste von Objekten, wobei jedes Objekt die Anzahl offener Anfragen (count) sowie die zugehörige Anfragekonfiguration (inquiryConfigId) angibt.

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/inquiries/open

Antwort:

{
    "items": [
        {
            "count": 3,
            "inquiryConfigId": "catalogue"
        },
        {
            "count": 15,
            "inquiryConfigId": "contact"
        },
        {
            "count": 1,
            "inquiryConfigId": "productQuestion"
        },
        {
            "count": 1,
            "inquiryConfigId": "returnInquiry"
        }
    ]
}

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Lesen von Anfragen.
503 Service Unavailable	"internalError"	Anfragen konnten nicht geladen werden.

3.4 PUT inquiries/{inquiryId}

Aktualisiert den Bearbeitungsstatus einer bestimmten Anfrage.

Mögliche Werte für processingStatus:

0 = New
1 = Read
2 = Answered
3 = Closed

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/inquiries/bda4c9c28ebc6920

Request body:

{
    "processingStatus": 1
}

Antwort:

{}

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Schreiben von Anfragen.
400 Bad Request		Request body konnte nicht geladen werden. `processingStatus` wurde nicht übergeben. Das Aktualisieren ist fehlgeschlagen.
400 Bad Request	"unknownDataField"	Es wird versucht, etwas außer `processingStatus` zu aktualisieren.
400 Bad Request	"invalidFormat"	`processingStatus` ist keine Zahl.
404 Not Found		Die Anfrage wurde nicht gefunden.
503 Service Unavailable	"internalError"	Die Anfrage konnte nicht entschlüsselt werden.

3.5 DELETE inquiries/{inquiryId}

Löscht eine bestimmte Anfrage dauerhaft.

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/inquiries/bda4c9c28ebc6920

Antwort:

{}

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Löschen von Anfragen.
404 Not Found		Die Anfrage wurde nicht gefunden.

4. Support

Bei technischen Fragen und Hilfestellungen ist unser Support-Team für Sie erreichbar: Zum Kundenportal

Bitte senden Sie uns eine möglichst detaillierte Beschreibung sowie Screenshots, Requests/Antworten damit wir Ihre Anfrage zeitnah und zielführend beantworten können.

API-Referenz Anfragen

Inhaltsverzeichnis

1. Unterstützte Methoden

2. Datenfelder

Beispiel:

3. Verwendung der Methoden

3.1 GET inquiries

Beispiel:

Antwort:

Filterfelder:

Sortierfelder:

Fehlercodes:

3.2 GET inquiries/{inquiryId}

Beispiel:

Antwort:

Fehlercodes:

3.3 GET inquiries/open

Beispiel:

Antwort:

Fehlercodes:

3.4 PUT inquiries/{inquiryId}

Beispiel:

Request body:

Antwort:

Fehlercodes:

3.5 DELETE inquiries/{inquiryId}

Beispiel:

Antwort:

Fehlercodes:

4. Support