Verbraucher-API

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 13 Minuten Lesedauer

    • Die Verbraucher Die API stellt Endpunkte zum Abrufen und Aktualisieren bereit Kundenservice-Management (CSM) Verbraucherdatensätze.

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

    Die Verbraucher Die API erfordert das Customer Service-Plugin (com.sn_customerservice) und wird in bereitgestellt Jetzt Namespace.

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

    Verbraucher – GET /now/Consumer

    Ruft einen angegebenen Satz von ab Kundenservice-Management (CSM) Verbraucherdatensätze.

    URL-Format

    Versionierte URL: /api/now/{api_Version}/Consumer

    Standard-URL: /api/now/Consumer

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. 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 der boolesche Parameter hasMoreWird zurückgegeben. Gibt an, ob weitere zurückzugebende Datensätze vorhanden 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.

    Zum 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 REST API-HTTP-Antwortcodes .

    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.

    Antworttext-Parameter (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 anwenderdefinierten 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:

    • Wahr: Verbraucher aktiv
    • Falsch: Verbraucher deaktiviert

    Datentyp: Boolesch

    Standardwert: wahr
    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 Daten 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 Vorname des Verbrauchers.

    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.

    Datentyp: Zeichenfolge

    Tabelle: Haushalt [csm_Household]
    last_name Nachname des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    Zweiter_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 Verbrauchername; First_Name+Middle_Name+Last_Name.

    Datentyp: Zeichenfolge

    Maximale Länge: 152
    Notizen 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: Zahl (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 Präfix für Verbrauchernamen, 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:

    • Wahr: Primärer Verbraucher
    • Falsch: Kein primärer Verbraucher

    Datentyp: Boolesch

    Standardwert: false
    Status Bundesland, in dem der Verbraucher wohnt.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Maximale Länge: 255
    Suffix Verbrauchernamenssuffix, z. B. Jr., SR. Oder II

    Datentyp: Zeichenfolge
    sys_created_by Anwender, 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 Gibt an, wie oft die zugehörigen Verbraucherinformationen geändert wurden.

    Datentyp: Zahl (Ganzzahl)
    sys_Tags System-Tags.

    Datentyp: Zeichenfolge
    sys_updated_by Anwender, 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 Verbraucherzeitzone, z. B. Kanada/Zentral oder USA/Ost.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Maximale Länge: 60
    Anwender SYS_ID des Verbraucheranwenders.

    Datentyp: Zeichenfolge

    Tabelle: Verbraucheranwender [csm_Consumer_user]
    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"
    }
  ]
}

    Verbraucher – GET /now/Consumer/{ID}

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

    URL-Format

    Versionierte URL: /api/now/{api_Version}/Consumer/{ID}

    Standard-URL: /api/now/Consumer/{ID}

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 7. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. 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 Verbraucherdatensatzes, der zurückgegeben werden soll.

    Datentyp: Zeichenfolge

    Tabelle: Verbraucher [csm_Consumer]
    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 REST API-HTTP-Antwortcodes .

    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.

    Antworttext-Parameter (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 anwenderdefinierten 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:

    • Wahr: Verbraucher aktiv
    • Falsch: Verbraucher deaktiviert

    Datentyp: Boolesch

    Standardwert: wahr
    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 Daten 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 Vorname des Verbrauchers.

    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.

    Datentyp: Zeichenfolge

    Tabelle: Haushalt [csm_Household]
    last_name Nachname des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    Zweiter_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 Verbrauchername; First_Name+Middle_Name+Last_Name.

    Datentyp: Zeichenfolge

    Maximale Länge: 152
    Notizen 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: Zahl (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 Präfix für Verbrauchernamen, 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:

    • Wahr: Primärer Verbraucher
    • Falsch: Kein primärer Verbraucher

    Datentyp: Boolesch

    Standardwert: false
    Status Bundesland, in dem der Verbraucher wohnt.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Maximale Länge: 255
    Suffix Verbrauchernamenssuffix, z. B. Jr., SR. Oder II

    Datentyp: Zeichenfolge
    sys_created_by Anwender, 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 Gibt an, wie oft die zugehörigen Verbraucherinformationen geändert wurden.

    Datentyp: Zahl (Ganzzahl)
    sys_updated_by Anwender, 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 Verbraucherzeitzone, z. B. Kanada/Zentral oder USA/Ost.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Maximale Länge: 60
    Anwender SYS_ID des Verbraucheranwenders.

    Datentyp: Zeichenfolge

    Tabelle: Verbraucheranwender [csm_Consumer_user]
    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: VERÖFFENTLICHEN SIE /now/Consumer

    Erstellt eine neue Kundenservice-Management (CSM) Verbraucher.

    Darüber hinaus können Sie mit diesem Endpunkt ein Profil für Social Media 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 einem übermäßigen 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

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 13. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. 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:

    • Wahr: Verbraucher aktiv
    • Falsch: Verbraucher deaktiviert

    Datentyp: Boolesch

    Standardwert: wahr
    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 Daten 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 Vorname des Verbrauchers.

    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.

    Datentyp: Zeichenfolge

    Tabelle: Haushalt [csm_Household]
    last_name Nachname des Verbrauchers.

    Datentyp: Zeichenfolge

    Maximale Länge: 50
    Zweiter_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 Verbrauchername; First_Name+Middle_Name+Last_Name.

    Datentyp: Zeichenfolge

    Maximale Länge: 152
    Notizen 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: Zahl (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 Präfix für Verbrauchernamen, 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:

    • Wahr: Primärer Verbraucher
    • Falsch: Kein 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 Anwender-Handle im Social Media-Kanal.

    Datentyp: Zeichenfolge
    Social_Handle_url URL zum Social Channel-Handle des Verbrauchers.

    Datentyp: Zeichenfolge
    Status Bundesland, in dem der Verbraucher wohnt.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Maximale Länge: 255
    Suffix Verbrauchernamenssuffix, 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 Verbraucherzeitzone, z. B. Kanada/Zentral oder USA/Ost.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Maximale Länge: 60
    Anwender SYS_ID des Verbraucheranwenders.

    Datentyp: Zeichenfolge

    Tabelle: Verbraucheranwender [csm_Consumer_user]
    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 REST API-HTTP-Antwortcodes .

    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.

    Antworttext-Parameter (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"
}