Verbraucher-API

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 13 Minuten Lesedauer

    • Mit der Consumer -API können Sie Kundenservice-Management (Customer Service Management, CSM) Verbraucherdatensätze abrufen und aktualisieren.

    Darüber hinaus können Sie beim Erstellen eines Verbrauchers neue Social Media-Profildatensätze generieren.

    Die Consumer -API erfordert das Plugin „Customer Service“ (com.sn_customerservice) und wird im Now-Namespace bereitgestellt.

    Benutzer benötigen die Rolle csm_ws_integration für vollständigen API-Zugriff.

    Verbraucher: GET /now/consumer

    Ruft einen angegebenen Satz von Kundenservice-Management (Customer Service Management, CSM) Verbraucherdatensätzen ab.

    URL-Format

    Versionierte URL: /api/now/{api_version}/consumer

    Standard-URL: /api/now/consumer

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 2. Abfrageparameter
    Name Beschreibung
    sysparm_limit
    Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter sysparm_offset, um den Datensatzabruf zu paginieren.

    In der Antwort wird der boolesche Parameter hasMore zurückgegeben. Gibt an, ob weitere Datensätze zurückzugeben sind, die die Filterkriterien erfüllen.

    Datentyp: Zahl

    Standard: 10
    sysparm_offset
    Startdatensatzindex, für den der Datensatz abgerufen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze.

    Wenn zum Beispiel dieser Endpunkt zum ersten Mal aufgerufen wird, ist sysparm_offset auf „0“ eingestellt. Verwenden Sie sysparm_offset=sysparm_offset+sysparm_limit zum einfachen Durchblättern aller verfügbaren Datensätze, bis das Ende aller Datensätze erreicht ist.

    Übergeben Sie keine negative Zahl im Parameter sysparm_offset.

    Datentyp: Zahl

    Standard: 0
    sysparm_query Codierte Abfrage zum Filtern der Ergebnismenge.

    Beispiel:

    sysparm_query=caller_id=javascript:gs.getUserID()^active=true

    Die codierte Abfrage unterstützt Sortieren nach. Verwenden Sie die Klauseln ORDERBY und ORDERBYDESC in sysparm_query, um Antworten anhand bestimmter Felder zu sortieren. Zum Beispiel filtert sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory alle aktiven Datensätze und sortiert die Ergebnisse zuerst in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie.

    Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Es werden dann nur Zeilen unter Verwendung des gültigen Teils der Abfrage zurückgegeben. Sie können dieses Verhalten mithilfe der Eigenschaft glide.invalid_query.returns_no_rows steuern. Legen Sie diese Eigenschaft auf „true“ fest, um bei einer ungültigen Abfrage keine Zeilen zurückzugeben.
    Hinweis:
    Diese Eigenschaft glide.invalid_query.returns_no_rows steuert das Verhalten aller Abfragen in der Instanz, beispielsweise in Listen, Skripts (GlideRecord.query()) und Webservice-APIs.

    Datentyp: Zeichenfolge
    Tabelle : 3. Anforderungstextparameter (XML oder JSON)
    Element Beschreibung
    Keine

    Kopfzeilen

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.

    Tabelle : 4. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json
    Tabelle : 5. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.

    Tabelle : 6. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    401 Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben.
    404 Nicht gefunden. Das angeforderte Element wurde nicht gefunden.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Antworttextparameter (JSON oder XML)

    Der Endpunkt kann die folgenden JSON- oder XML-Elemente im Antworttext zurückgeben. Zusätzlich zur Liste der unten definierten Elemente (die die Elemente in einem Basissystem definieren) gibt der Endpunkt auch alle benutzerdefinierten Felder zurück, die der Tabelle „Verbraucher“ [csm_consumer] hinzugefügt wurden. Weitere Informationen zu diesen Elementen finden Sie in Ihrer spezifischen Tabellendefinition [Systemdefinition > Tabellen].

    Element Beschreibung
    aktiv Kennzeichnung, die angibt, ob der Verbraucher aktiv ist.

    Mögliche Werte:

    • true: Verbraucher aktiv
    • false: Verbraucher deaktiviert

    Datentyp: Boolesch

    Standardwert: true
    business_phone Geschäftliche Telefonnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    city Stadt, in der der Verbraucher wohnt.

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    country Land, in dem der Verbraucher wohnt.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    date_format Format, in dem Datumsangaben angezeigt werden sollen.

    Gültige Werte:

    • TT-MM-JJJJ
    • TT/MM/JJJJ
    • TT.MM.JJJJ
    • MM-TT-JJJJ
    • JJJJ-MM-TT

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    Standard: leer (Systemdatumsformat)
    E-Mail E-Mail-Adresse des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Fax Faxnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    first_name Verbrauchervorname.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    Geschlecht Geschlecht des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    home_phone Private Telefonnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    ​Haushalt Sys_id des Datensatzes, der die Haushaltsmerkmale beschreibt. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge
    last_name Nachname des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    Middle_name Zweiter Vorname des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    mobile_phone Mobiltelefonnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Name Vollständiger Name des Verbrauchers; first_name+middle_name+last_name.

    Datentyp: Zeichenfolge

    Maximale Länge: 152
    notes Hinweise zum Verbraucher.

    Datentyp: Zeichenfolge

    Maximale Länge: 4.000
    Benachrichtigung Gibt an, ob der Verbraucher Benachrichtigungen erhalten soll.

    Gültige Werte:

    • 1: Deaktiviert
    • 2: Aktiviert

    Datentyp: Ganzzahl

    Maximale Länge: 40

    Standardwert: 2
    Nummer Eindeutige Nummer, die dem Verbraucher zugeordnet ist.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Foto Foto des Verbrauchers.

    Datentyp: Bild
    preferred_language Primäre Sprache des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 3
    Präfix Verbrauchernamenpräfix, z. B. Dr., Mr., Mrs. oder Ms.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    primär Kennzeichnung, die angibt, ob dies der primäre Verbraucher ist.

    Mögliche Werte:

    • true: Primärer Verbraucher
    • false: Nicht primärer Verbraucher

    Datentyp: Boolesch

    Standardwert: false
    Status Bundesstaat, in dem sich der Verbraucher befindet.

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Straße Straße und Hausnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 255
    Suffix Suffix des Verbrauchernamens, z. B. Jr., Sr. oder II.

    Datentyp: Zeichenfolge
    sys_created_by Benutzer, der den Verbraucherdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    sys_created_on Datum und Uhrzeit der ursprünglichen Erstellung des Verbraucherdatensatzes.

    Datentyp: Zeichenfolge
    sys_domain ServiceNow Domäne, in der sich die Verbraucherinformationen befinden.

    Datentyp: Zeichenfolge
    sys_id Eindeutiger Bezeichner für den Verbraucher.

    Datentyp: Zeichenfolge
    sys_mod_count Anzahl der Änderungen der zugeordneten Verbraucherinformationen.

    Datentyp: Ganzzahl
    sys_tags System-Tags.

    Datentyp: Zeichenfolge
    sys_updated_by Benutzer, der die Verbraucherinformationen zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    sys_updated_on Datum und Uhrzeit der letzten Aktualisierung der Verbraucherinformationen.

    Datentyp: Zeichenfolge
    time_format Format, in dem die Zeit angezeigt werden soll.

    Gültige Werte:

    • hh.mm.ss a: hh.mm.ss (12 Stunden)
    • hh:mm:ss a: hh:mm:ss (12 Stunden)
    • HH.mm.ss: hh.mm.ss (24 Stunden)
    • HH:mm:ss: hh:mm:ss (24 Stunden)

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    Standard: leer (Systemzeitformat)
    time_zone Zeitzone des Verbrauchers, z. B. Kanada/Zentral oder USA/Ost.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Titel Geschäftsbezeichnung des Verbrauchers, z. B. Manager, Softwareentwickler oder Auftragnehmer.

    Datentyp: Zeichenfolge

    Maximale Länge: 60
    Anwender Sys_id des Verbraucherbenutzers. Befindet sich in der Tabelle „Verbraucherbenutzer“ [csm_consumer_user].

    Datentyp: Zeichenfolge
    Postleitzahl Postleitzahl des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    cURL-Anforderung

    curl "https://instance.servicenow.com/api/now/consumer?sysparm_query=account=86837a386f0331003b3c498f5d3ee4ca&sysparm_limit=2&sysparm_offset=2>;rel="next" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
    {
  "result": [
    {
      "country": "USA",
      "notes": "",
      "gender": "Male",
      "city": "Plano",
      "prefix": "",
      "sys_updated_on": "2016-08-12 00:19:12",
      "suffix": "",
      "title": "",
      "number": "CSMR0000004",
      "notification": "2",
      "sys_id": "01d8403fdb1b1200b6075200cf961941",
      "business_phone": "",
      "sys_updated_by": "prithvi",
      "mobile_phone": "",
      "street": "6900 Dallas Pkwy",
      "sys_created_on": "2016-06-16 19:20:13",
      "sys_domain": "global",
      "state": "TX",
      "fax": "",
      "first_name": "Harding",
      "email": "harding.asher@mailinator.com",
      "preferred_language": "",
      "sys_created_by": "guest",
      "zip": "75024",
      "home_phone": "",
      "time_format": "",
      "sys_mod_count": "8",
      "last_name": "Asher",
      "photo": "",
      "active": "true",
      "middle_name": "",
      "time_zone": "",
      "sys_tags": "",
      "name": "Harding Asher",
      "household": "",
      "date_format": "",
      "user": "c3d35d82c37122005871d44d81d3ae91",
      "primary": "false"
    },
    {
      "country": "USA",
      "notes": "",
      "gender": "Male",
      "city": "San Francisco",
      "prefix": "",
      "sys_updated_on": "2016-08-12 00:20:27",
      "suffix": "",
      "title": "",
      "number": "CSMR0000002",
      "notification": "2",
      "sys_id": "a0488cfbdb1b1200b6075200cf9619db",
      "business_phone": "",
      "sys_updated_by": "prithvi",
      "mobile_phone": "",
      "street": "144 2nd St",
      "sys_created_on": "2016-06-16 19:17:44",
      "sys_domain": "global",
      "state": "CA",
      "fax": "",
      "first_name": "Sam",
      "email": "sam.collins@mailinator.com",
      "preferred_language": "",
      "sys_created_by": "guest",
      "zip": "94105",
      "home_phone": "",
      "time_format": "",
      "sys_mod_count": "13",
      "last_name": "Collins",
      "photo": "",
      "active": "true",
      "middle_name": "",
      "time_zone": "",
      "sys_tags": "",
      "name": "Sam Collins",
      "household": "",
      "date_format": "",
      "user": "64488cfbdb1b1200b6075200cf9619db",
      "primary": "false"
    }
  ]
}

    Consumer – GET /now/consumer/{id}

    Ruft den angegebenen Kundenservice-Management (Customer Service Management, CSM) Verbraucherdatensatz ab.

    URL-Format

    Versionierte URL: /api/now/{api_version}/consumer/{id}

    Standard-URL: /api/now/consumer/{id}

    Unterstützte Anforderungsparameter

    Tabelle : 7. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    id Sys_id des zurückzugebenden Verbraucherdatensatzes. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge
    Tabelle : 8. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 9. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    Keine

    Kopfzeilen

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.

    Tabelle : 10. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json
    Tabelle : 11. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.

    Tabelle : 12. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    401 Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben.
    404 Gibt an, dass die Anforderung ungültig ist. Möglicherweise liegt einer der folgenden Gründe vor:
    • Angeforderter Fall ist nicht vorhanden.
    • Anwender hat keinen Zugriff auf den Verbraucherdatensatz.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Antworttextparameter (JSON oder XML)

    Der Endpunkt kann die folgenden JSON- oder XML-Elemente im Antworttext zurückgeben. Zusätzlich zur Liste der unten definierten Elemente (die die Elemente in einem Basissystem definieren) gibt der Endpunkt auch alle benutzerdefinierten Felder zurück, die der Tabelle „Verbraucher“ [csm_consumer] hinzugefügt wurden. Weitere Informationen zu diesen Elementen finden Sie in Ihrer spezifischen Tabellendefinition [Systemdefinition > Tabellen].

    Element Beschreibung
    aktiv Kennzeichnung, die angibt, ob der Verbraucher aktiv ist.

    Mögliche Werte:

    • true: Verbraucher aktiv
    • false: Verbraucher deaktiviert

    Datentyp: Boolesch

    Standardwert: true
    business_phone Geschäftliche Telefonnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    city Stadt, in der der Verbraucher wohnt.

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    country Land, in dem der Verbraucher wohnt.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    date_format Format, in dem Datumsangaben angezeigt werden sollen.

    Gültige Werte:

    • TT-MM-JJJJ
    • TT/MM/JJJJ
    • TT.MM.JJJJ
    • MM-TT-JJJJ
    • JJJJ-MM-TT

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    Standard: leer (Systemdatumsformat)
    E-Mail E-Mail-Adresse des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Fax Faxnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    first_name Verbrauchervorname.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    Geschlecht Geschlecht des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    home_phone Private Telefonnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    ​Haushalt Sys_id des Datensatzes, der die Haushaltsmerkmale beschreibt. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge
    last_name Nachname des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    Middle_name Zweiter Vorname des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    mobile_phone Mobiltelefonnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Name Vollständiger Name des Verbrauchers; first_name+middle_name+last_name.

    Datentyp: Zeichenfolge

    Maximale Länge: 152
    notes Hinweise zum Verbraucher.

    Datentyp: Zeichenfolge

    Maximale Länge: 4.000
    Benachrichtigung Gibt an, ob der Verbraucher Benachrichtigungen erhalten soll.

    Gültige Werte:

    • 1: Deaktiviert
    • 2: Aktiviert

    Datentyp: Ganzzahl

    Maximale Länge: 40

    Standardwert: 2
    Nummer Eindeutige Nummer, die dem Verbraucher zugeordnet ist.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Foto Foto des Verbrauchers.

    Datentyp: Bild
    preferred_language Primäre Sprache des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 3
    Präfix Verbrauchernamenpräfix, z. B. Dr., Mr., Mrs. oder Ms.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    primär Kennzeichnung, die angibt, ob dies der primäre Verbraucher ist.

    Mögliche Werte:

    • true: Primärer Verbraucher
    • false: Nicht primärer Verbraucher

    Datentyp: Boolesch

    Standardwert: false
    Status Bundesstaat, in dem sich der Verbraucher befindet.

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Straße Straße und Hausnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 255
    Suffix Suffix des Verbrauchernamens, z. B. Jr., Sr. oder II.

    Datentyp: Zeichenfolge
    sys_created_by Benutzer, der den Verbraucherdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    sys_created_on Datum und Uhrzeit der ursprünglichen Erstellung des Verbraucherdatensatzes.

    Datentyp: Zeichenfolge
    sys_domain ServiceNow Domäne, in der sich die Verbraucherinformationen befinden.

    Datentyp: Zeichenfolge
    sys_id Eindeutiger Bezeichner für den Verbraucher.

    Datentyp: Zeichenfolge
    sys_mod_count Anzahl der Änderungen der zugeordneten Verbraucherinformationen.

    Datentyp: Ganzzahl
    sys_updated_by Benutzer, der die Verbraucherinformationen zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    sys_updated_on Datum und Uhrzeit der letzten Aktualisierung der Verbraucherinformationen.

    Datentyp: Zeichenfolge
    time_format Format, in dem die Zeit angezeigt werden soll.

    Gültige Werte:

    • hh.mm.ss a: hh.mm.ss (12 Stunden)
    • hh:mm:ss a: hh:mm:ss (12 Stunden)
    • HH.mm.ss: hh.mm.ss (24 Stunden)
    • HH:mm:ss: hh:mm:ss (24 Stunden)

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    Standard: leer (Systemzeitformat)
    time_zone Zeitzone des Verbrauchers, z. B. Kanada/Zentral oder USA/Ost.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Titel Geschäftsbezeichnung des Verbrauchers, z. B. Manager, Softwareentwickler oder Auftragnehmer.

    Datentyp: Zeichenfolge

    Maximale Länge: 60
    Anwender Sys_id des Verbraucherbenutzers. Befindet sich in der Tabelle „Verbraucherbenutzer“ [csm_consumer_user].

    Datentyp: Zeichenfolge
    Postleitzahl Postleitzahl des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    cURL-Anforderung

    curl "https://instance.servicenow.com/api/now/consumer/01d8403fdb1b1200b6075200cf961941 \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

    {
  "result": {
    "country": "USA",
    "notes": "",
    "gender": "Male",
    "city": "Plano",
    "prefix": "",
    "sys_updated_on": "2016-08-12 00:19:12",
    "suffix": "",
    "title": "",
    "number": "CSMR0000004",
    "notification": "2",
    "sys_id": "01d8403fdb1b1200b6075200cf961941",
    "business_phone": "",
    "sys_updated_by": "prithvi",
    "mobile_phone": "",
    "street": "6900 Dallas Pkwy",
    "sys_created_on": "2016-06-16 19:20:13",
    "sys_domain": "global",
    "state": "TX",
    "fax": "",
    "first_name": "Harding",
    "email": "harding.asher@mailinator.com",
    "preferred_language": "",
    "sys_created_by": "guest",
    "zip": "75024",
    "home_phone": "",
    "time_format": "",
    "sys_mod_count": "8",
    "last_name": "Asher",
    "photo": "",
    "active": "true",
    "middle_name": "",
    "time_zone": "",
    "sys_tags": "",
    "name": "Harding Asher",
    "household": "",
    "date_format": "",
    "user": "c3d35d82c37122005871d44d81d3ae91",
    "primary": "false"
  }
}

    Verbraucher: POST /now/consumer

    Erstellt einen neuen Kundenservice-Management (Customer Service Management, CSM) Verbraucher.

    Darüber hinaus können Sie mit diesem Endpunkt ein Social Media-Profil für den Verbraucher erstellen. Um das Profil zu erstellen, müssen Sie die folgenden Parameter im Anforderungstext angeben:
    • social_channel
    • social_handle
    • social_handle_url
    Warnung:
    Dieser Endpunkt führt keine Parametervalidierung durch, da dies zu übermäßigem Overhead führen kann. Wenn ein Anforderungsparameter falsch geschrieben ist, ungültig ist oder vom Endpunkt nicht unterstützt wird, wird er ohne Warnung ignoriert.

    URL-Format

    Versionierte URL: /api/now/{api_version}/consumer

    Standard-URL: /api/now/consumer

    Unterstützte Anforderungsparameter

    Tabelle : 13. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 14. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 15. Anforderungstextparameter (XML oder JSON)
    Element Beschreibung
    aktiv Kennzeichnung, die angibt, ob der Verbraucher aktiv ist.

    Mögliche Werte:

    • true: Verbraucher aktiv
    • false: Verbraucher deaktiviert

    Datentyp: Boolesch

    Standardwert: true
    business_phone Geschäftliche Telefonnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    city Stadt, in der der Verbraucher wohnt.

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    country Land, in dem der Verbraucher wohnt.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    date_format Format, in dem Datumsangaben angezeigt werden sollen.

    Gültige Werte:

    • TT-MM-JJJJ
    • TT/MM/JJJJ
    • TT.MM.JJJJ
    • MM-TT-JJJJ
    • JJJJ-MM-TT

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    Standard: leer (Systemdatumsformat)
    E-Mail E-Mail-Adresse des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Fax Faxnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    first_name Verbrauchervorname.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    Geschlecht Geschlecht des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    home_phone Private Telefonnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    ​Haushalt Sys_id des Datensatzes, der die Haushaltsmerkmale beschreibt. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge
    last_name Nachname des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    Middle_name Zweiter Vorname des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    mobile_phone Mobiltelefonnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Name Vollständiger Name des Verbrauchers; first_name+middle_name+last_name.

    Datentyp: Zeichenfolge

    Maximale Länge: 152
    notes Hinweise zum Verbraucher.

    Datentyp: Zeichenfolge

    Maximale Länge: 4.000
    Benachrichtigung Gibt an, ob der Verbraucher Benachrichtigungen erhalten soll.

    Gültige Werte:

    • 1: Deaktiviert
    • 2: Aktiviert

    Datentyp: Ganzzahl

    Maximale Länge: 40

    Standardwert: 2
    Foto Foto des Verbrauchers.

    Datentyp: Bild
    preferred_language Primäre Sprache des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 3
    Präfix Verbrauchernamenpräfix, z. B. Dr., Mr., Mrs. oder Ms.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    primär Kennzeichnung, die angibt, ob dies der primäre Verbraucher ist.

    Mögliche Werte:

    • true: Primärer Verbraucher
    • false: Nicht primärer Verbraucher

    Datentyp: Boolesch

    Standardwert: false
    Social_Channel Social Media-Kanal, dem der Verbraucher zugeordnet ist, z. B. Twitter, Facebook oder Instagram.

    Datentyp: Zeichenfolge
    „social_handle“. Benutzer-Handle im Social Media-Kanal.

    Datentyp: Zeichenfolge
    „social_handle_url“. URL zum Handle des sozialen Kanals des Verbrauchers.

    Datentyp: Zeichenfolge
    Status Bundesstaat, in dem sich der Verbraucher befindet.

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Straße Straße und Hausnummer des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 255
    Suffix Suffix des Verbrauchernamens, z. B. Jr., Sr. oder II.

    Datentyp: Zeichenfolge
    time_format Format, in dem die Zeit angezeigt werden soll.

    Gültige Werte:

    • hh.mm.ss a: hh.mm.ss (12 Stunden)
    • hh:mm:ss a: hh:mm:ss (12 Stunden)
    • HH.mm.ss: hh.mm.ss (24 Stunden)
    • HH:mm:ss: hh:mm:ss (24 Stunden)

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    Standard: leer (Systemzeitformat)
    time_zone Zeitzone des Verbrauchers, z. B. Kanada/Zentral oder USA/Ost.

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Titel Geschäftsbezeichnung des Verbrauchers, z. B. Manager, Softwareentwickler oder Auftragnehmer.

    Datentyp: Zeichenfolge

    Maximale Länge: 60
    Anwender Sys_id des Verbraucherbenutzers. Befindet sich in der Tabelle „Verbraucherbenutzer“ [csm_consumer_user].

    Datentyp: Zeichenfolge
    Postleitzahl Postleitzahl des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    Header

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.

    Tabelle : 16. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützt nur application/json.
    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 17. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.

    Tabelle : 18. Statuscodes
    Statuscode Beschreibung
    201 Neuer Verbraucherdatensatz wurde erfolgreich erstellt.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    401 Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben.
    500 Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten.

    Antworttextparameter (JSON oder XML)

    Element Beschreibung
    Ergebnis Sys_id des neu erstellten Verbraucherdatensatzes.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    curl -X POST "https://instance.servicenow.com/api/now/consumer" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d " { \
  "country": "USA", \
  "notes": "Never comes in before 10am", \
  "gender": "Female", \
  "city": "San Marcos", \
  "prefix": "Ms", \
  "title": "Director", \
  "notification": "1", \
  "business_phone": "(555)555-1234", \
  "mobile_phone": "(555)555-1235", \
  "street": "123 Sesame St", \
  "state": "CA", \
  "fax": "(555)555-1236", \
  "first_name": "Jane", \
  "zip": "92001", \
  "home_phone": "(555)555-1234", \
  "last_name": "Brown", \
  "active": "true", \
  "middle_name": "Dell", \
  "time_zone": "PST", \
  "name": "Jane Brown", \
  "household": "4", \
  "user": "c3d35d82c37122005871d44d81d3ae91", \
  "primary": "false" \
}"
--user "username":"password"
    {
    "result": "0f5c13addb93230057c3fd441d9619b8"
}