---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference
Release :
- xanadu
ft:locale :
- de-DE
ft:publication_title :
- Xanadu-API-Referenz
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# Kontakt-API
# Kontakt-API {#ariaid-title1}
* Freigeben Version: Xanadu
*
* Aktualisiert 1. August 2024
*
*  20 Minuten Lesedauer
Die Kontakt- API stellt Endpunkte bereit, mit denen Sie Kundenservice-Management (CSM) Kontaktdatensätze abrufen und aktualisieren können.
Darüber hinaus können Sie beim Erstellen eines Kontakts neue Social Media-Profildatensätze generieren.
Die Contact API erfordert das Plugin „Customer Service" (com.sn_customerservice) und wird im `Now` -Namespace bereitgestellt.
Benutzer benötigen die Rolle csm_ws_integration, um vollständigen API-Zugriff zu erhalten.
## Kontakt: GET /now/contact {#ariaid-title2}
Ruft einen angegebenen Satz von Kundenservice-Management (CSM) Kontakten ab.
### URL-Format
URL mit Versionsnummer: /api/now/{api_version}/contact
Standard-URL: /api/now/contact
### Unterstützte Anforderungsparameter
{#contact-GET__entry__2}{#contact-GET__version-RESTAPI}
| 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 : 1. Pfadparameter]
{#contact-GET__entry__6}{#contact-GET__sysparm-limit-entry}{#contact-GET__sysparm-offset-entry}{#contact-GET__sysparm-query-entry}
| 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ückgegeben werden, 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=wahr` 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 : 2. Abfrageparameter]
{#contact-GET__entry__14}
| Name | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 3. Anforderungstextparameter (XML oder JSON)]
### 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](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#contact-GET__entry__18}{#contact-GET__accept-RESTAPI}
| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen]
{#contact-GET__entry__22}
| Kopfzeile | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 5. Antwortkopfzeilen]
### 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-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#contact-GET__entry__26}{#contact-GET__entry-200-status-code}{#contact-GET__entry-500-status-code}{#contact-GET__d2755e813}
| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]
### Parameter des Antworttexts (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 „Kontakt" \[customer_contact\] hinzugefügt wurden. Weitere Informationen zu diesen Elementen finden Sie in Ihrer spezifischen Tabellendefinition \[SystemdefinitionTabellen\].
{#contact-GET__csmcontact_response_parms__entry__2}{#contact-GET__contacttable-account-enrty}{#contact-GET__contacttable-active-entry}{#contact-GET__contacttable-agent_status-entry}{#contact-GET__contacttable-building-entry}{#contact-GET__contacttable-calendar_integration-entry}{#contact-GET__contacttable-city-entry}{#contact-GET__contacttable-company-entry}{#contact-GET__contacttable-cost_center-entry}{#contact-GET__contacttable-country-entry}{#contact-GET__contacttable-date_format-entry}{#contact-GET__contacttable-default_perspective-entry}{#contact-GET__contacttable-department-entry}{#contact-GET__contacttable-edu_status-entry}{#contact-GET__contacttable-email-entry}{#contact-GET__contacttable-employee_number-entry}{#contact-GET__contacttable-enable_multifactor_authn-entry}{#contact-GET__contacttable-failed_attempts-entry}{#contact-GET__contacttable-first_name-entry}{#contact-GET__contacttable-gender-entry}{#contact-GET__contacttable-geolocation_tracked-entry}{#contact-GET__contacttable-home_phone-entry}{#contact-GET__contacttable-internal_integration_user-entry}{#contact-GET__contacttable-introduction-entry}{#contact-GET__contacttable-last_login-entry}{#contact-GET__contacttable-last_login_device-entry}{#contact-GET__contacttable-last_login_time-entry}{#contact-GET__contacttable-last_name-entry}{#contact-GET__contacttable-last_position_update-entry}{#contact-GET__contacttable-latitude-entry}{#contact-GET__contacttable-ldap_server-entry}{#contact-GET__contacttable-location-entry}{#contact-GET__contacttable-locked_out-entry}{#contact-GET__contacttable-longitude-entry}{#contact-GET__contacttable-manager-entry}{#contact-GET__contacttable-middle_name-entry}{#contact-GET__contacttable-mobile_phone-entry}{#contact-GET__contacttable-name-entry}{#contact-GET__contacttable-notification-entry}{#contact-GET__contacttable-on_schedule-entry}{#contact-GET__contacttable-phone-entry}{#contact-GET__contacttable-photo-entry}{#contact-GET__contacttable-preferred_language-entry}{#contact-GET__contacttable-roles-entry}{#contact-GET__contacttable-schedule-entry}{#contact-GET__contacttable-source-entry}{#contact-GET__contacttable-state-entry}{#contact-GET__contacttable-street-entry}{#contact-GET__contacttable-sys_class_name-entry}{#contact-GET__contacttable-sys_created_by-entry}{#contact-GET__contacttable-sys_created_on-entry}{#contact-GET__contacttable-sys_domain-entry}{#contact-GET__contacttable-sys_domain_path-entry}{#contact-GET__contacttable-sys_id-entry}{#contact-GET__contacttable-sys_mod_count-entry}{#contact-GET__contacttable-sys_updated_by-entry}{#contact-GET__contacttable-sys_updated_on-entry}{#contact-GET__contacttable-time_format-entry}{#contact-GET__contacttable-time_sheet_policy-entry}{#contact-GET__contacttable-time_zone-entry}{#contact-GET__contacttable-title-entry}{#contact-GET__contacttable-user_name-entry}{#contact-GET__contacttable-vip-entry}{#contact-GET__contacttable-web_service_access_only-entry}{#contact-GET__contacttable-zip-entry}
| Element | Beschreibung |
|-|-|
| Account | Sys_id des Account-Datensatzes, dem der Kontakt zugeordnet ist; Tabelle „Account \[customer_account\]". Datentyp: Zeichenfolge |
| aktiv | Kennzeichnung, die angibt, ob der Kontakt im System aktiv ist. Mögliche Werte: * wahr: Kontakt ist aktiv * „falsch": Kontakt ist inaktiv Datentyp: Boolesch Standardwert: true |
| agent_status | Status des Service Desk-Mitarbeiters. Mögliche Werte: * Nicht in Arbeit * In Pause * Unterwegs * Am Standort Datentyp: Zeichenfolge Maximale Länge: 40 |
| Gebäude | Sys_id des Datensatzes, der das Gebäude beschreibt, in dem sich der Kontakt befindet Tabelle „Gebäude" \[cmn_building\]. Datentyp: Zeichenfolge |
| calendar_integration | Kalenderanwendung, die der Kontakt verwendet. 1: Outlook Datentyp: Zahl (Ganzzahl) Standard: 1 |
| city | Stadt, in der sich der Kontakt befindet Datentyp: Zeichenfolge Maximale Länge: 40 |
| Unternehmen | Sys_id des Unternehmensdatensatzes, dem der Kontakt zugeordnet ist Tabelle „Unternehmen" \[core_company\]. Datentyp: Zeichenfolge |
| cost_center | Sys_id der Kostenstelle, die dem Kontakt zugeordnet ist Tabelle „Kostenstelle" \[cmn_cost_center\]. Datentyp: Zeichenfolge |
| country | Ländercode des Landes, in dem der Kontakt ansässig ist Datentyp: Zeichenfolge Maximale Länge: 3 |
| date_format | Format, in dem Daten für Kontakte 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) |
| default_perperspektive | Sys_id der Standardperspektive für den Kontakt Befindet sich in der Tabelle „Menüliste" \[sys_peroption\]. Datentyp: Zeichenfolge |
| department | Sys_id der Abteilung, die dem Kontakt zugeordnet ist. Befindet sich in der Tabelle „Abteilung" \[cmn_department\]. Datentyp: Zeichenfolge |
| edu_status | Bildungsstatus des zugeordneten Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Lehrende |
| E-Mail | Kontakt-E-Mail-Adresse. Datentyp: Zeichenfolge |
| employee_number | Mitarbeiternummer des Kontakts. Datentyp: Zeichenfolge |
| enable_multifactor_authn | Kennzeichnung, die angibt, ob eine Multifaktor-Autorisierung erforderlich ist, damit sich der Kontakt beim Serviceportal anmelden kann. Mögliche Werte: * „wahr": Multifaktor-Autorisierung aktiviert * „falsch": Multifaktor-Autorisierung deaktiviert Datentyp: Boolesch Standardwert: false |
| „failed_attempts" | Anzahl der fehlgeschlagenen Anmeldeversuche. Datentyp: Zahl (Ganzzahl) |
| first_name | Vorname des Kontakts Datentyp: Zeichenfolge Maximale Länge: 50 |
| Geschlecht | Kontaktgeschlecht. Datentyp: Zeichenfolge Maximale Länge: 40 |
| geolocation_tracked | Kennzeichnung, die angibt, ob der Kontaktstandort durch Geotracking abgerufen wurde. Mögliche Werte: * true: Durch Geotracking ermittelter Kontaktstandort * „falsch": Kontaktstandort nicht durch Geotracking ermittelt Datentyp: Boolesch Standardwert: falsch |
| home_phone | Private Telefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| internal_integration_user | Kennzeichnung, die angibt, ob der Kontakt ein interner Integrationsbenutzer ist. Mögliche Werte: * true: Interner Integrationsanwender * „false": Anderer Anwendertyp Datentyp: Boolesch Standardwert: false |
| Einführung | Einführung Datentyp: Zeichenfolge Maximale Länge: 40 |
| last_login | Datum, an dem sich der Kontakt zuletzt beim System angemeldet hat. Datentyp: Zeichenfolge (Datum) |
| last_login_device | Gerät, das der Verbraucher bei seiner letzten Anmeldung beim System verwendet hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| last_login_time | Zeitpunkt (Datum und Uhrzeit), zu dem der Kontakt beim System angemeldet wurde. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| last_name | Nachname des Kontakts Datentyp: Zeichenfolge Maximale Länge: 50 |
| last_position_update | Datum und Uhrzeit der Aktualisierung der letzten Position. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| latitude | Breitengradkoordinate des Kontakts Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40 |
| ldap_server | Sys_id des LDAP-Servers, der vom Kontakt zur letzten Anmeldung beim System verwendet wurde; LDAP-Servertabelle \[ldap_server_config\]. Datentyp: Zeichenfolge |
| location | Sys_id des Datensatzes, der den Standort des Kontakts beschreibt; Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| locked_out | Kennzeichnung, die angibt, ob der Kontakt gesperrt ist. Mögliche Werte: * wahr: Kontakt gesperrt * „falsch": Kontakt nicht gesperrt Datentyp: Boolesch Standardwert: false |
| longitude | Längengradkoordinate des Kontakts. Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40 |
| Manager | Sys_id des Datensatzes, die den direkten Vorgesetzten des Kontakts beschreibt; Benutzertabelle \[sys_user\]. Datentyp: Zeichenfolge |
| Middle_name | Zweiter Vorname des Kontakts Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 50 |
| mobile_phone | Mobiltelefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| name | Vollständiger Name des Kontakts Datentyp: Zeichenfolge Maximale Länge: 151 |
| Benachrichtigung | Gibt an, ob der Kontakt Benachrichtigungen erhalten soll. Gültige Werte: * 1: Deaktiviert * 2: Aktiviert Datentyp: Zahl (Ganzzahl) Standardwert: 2 |
| on_schedule | Gibt die Pünktlichkeit des entsandten Servicepersonals an. Gültige Werte: * Ahead: Vor dem Zeitplan. * behind_less30: Hinter Zeitplan, aber weniger als 30 Minuten. * behind_30to60: Hinter dem Zeitplan zwischen 30 und 60 Minuten. * behind_more60: Mehr als 60 Minuten hinter dem Zeitplan. * on_time: Gemäß Zeitplan. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Telefon | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Foto | Foto des Kontakts Datentyp: Bild |
| preferred_language | Ländercode der primären Sprache des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 3 |
| Rollen | Liste der Anwenderrollen, die dem Kontakt zugeordnet sind. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Zeitplan | Sys_id des Datensatzes, der den Arbeitszeitplan für den zugeordneten Kontakt beschreibt; Tabelle „Zeitplan" \[cmn_schedule\]. Datentyp: Zeichenfolge |
| Quelle | Quelle des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Staat | Bundesstaat, in dem sich der Kontakt befindet. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Straße | Straße des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| sys_class_name | Tabelle, die den Kontaktdatensatz enthält. Datentyp: Zeichenfolge Maximale Länge: 80 |
| sys_created_by | Benutzer, der den zugehörigen Kontaktdatensatz ursprünglich erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_created_on | Datum und Uhrzeit der ursprünglichen Erstellung des zugeordneten Kontakts. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| sys_domain | ServiceNow Instanzdomäne des zugeordneten Kontaktdatensatzes. Datentyp: Zeichenfolge |
| sys_domain_path | Pfad der Domäne des Kontaktdatensatzes. Datentyp: Zeichenfolge Maximale Länge: 255 Standard: / (global) |
| sys_id | Eindeutiger Bezeichner für den zugeordneten Kontaktdatensatz. Datentyp: Zeichenfolge |
| sys_mod_count | Anzahl der Male, mit denen der zugeordnete Kontaktdatensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| sys_tags | System-Tags. Datentyp: Zeichenfolge |
| sys_updated_by | Benutzer, der die zugeordneten Kontaktinformationen zuletzt aktualisiert hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_updated_on | Datum und Uhrzeit der Aktualisierung der zugehörigen Kontaktinformationen. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| 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_sheet_policy\] | Sys_id des Datensatzes, der die Zeitnachweisrichtlinie für den zugeordneten Kontakt enthält Tabelle „Zeitnachweisrichtlinie" \[time_sheet_policy\]. Datentyp: Zeichenfolge |
| time_zone | Zeitzone, in der sich der Kontakt befindet, z. B. Kanada/Zentral oder USA/Ost. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Titel | Geschäftsbezeichnung des Kontakts, z. B. Manager, Softwareentwickler oder Auftragnehmer. Datentyp: Zeichenfolge Maximale Länge: 60 |
| user_name | Kontaktbenutzer-ID. Datentyp: Zeichenfolge Maximale Länge: 40 |
| VIP | Kennzeichnung, die angibt, ob der zugeordnete Kontakt einen VIP-Status hat. Mögliche Werte: * wahr: VIP * false: Nicht VIP Datentyp: Boolesch Standardwert: false |
| web_service_access_only | Kennzeichnung, die angibt, ob der Kontakt nur über das Internet auf Services zugreifen kann. Mögliche Werte: * true: Nur Webzugriff * false: Zugriff über alle verfügbaren Methoden Datentyp: Boolesch Standardwert: false |
| Postleitzahl | Postleitzahl des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
[ ]
### cURL-Anforderung
curl "https://instance.servicenow.com/api/now/contact?sysparm_query=account=86837a386f0331003b3c498f5d3ee4ca&sysparm_limit=2&sysparm_offset=2>;rel="next" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
{
"result": [
{
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2018-03-10 21:48:11",
"last_login_device": "",
"source": "",
"sys_updated_on": "2019-01-03 05:49:34",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"sys_updated_by": "system",
"enable_multifactor_authn": "false",
"sys_created_on": "2018-03-04 20:26:32",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "admin",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "+1 858 287 7834",
"cost_center": "",
"name": "George Warren",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "george.warren",
"failed_attempts": "",
"edu_status": "",
"latitude": "",
"roles": "",
"title": "Network Administrator",
"sys_class_name": "customer_contact",
"sys_id": "ddce70866f9331003b3c498f5d3ee417",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "+1 858 867 7857",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "George",
"preferred_language": "",
"introduction": "",
"email": "geo.warren@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "3",
"last_name": "Warren",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "25ab8e460a0a0bb300857304ff811af5",
"account": "86837a386f0331003b3c498f5d3ee4ca"
},
{
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2019-01-03 15:08:57",
"last_login_device": "73.71.157.241",
"source": "",
"sys_updated_on": "2019-01-03 23:26:12",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"sys_updated_by": "admin",
"enable_multifactor_authn": "false",
"sys_created_on": "2019-01-03 15:07:25",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "carl.customer",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "+16692627777",
"cost_center": "",
"name": "Jane Contact",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "Jane.Contact",
"failed_attempts": "",
"edu_status": "faculty",
"latitude": "",
"roles": "",
"title": "",
"sys_class_name": "customer_contact",
"sys_id": "0a232a0013691200042ab3173244b075",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "Jane",
"preferred_language": "",
"introduction": "",
"email": "jane.contact@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "3",
"last_name": "Contact",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "",
"account": "86837a386f0331003b3c498f5d3ee4ca"
}
]
}
## Kontakt -- GET /now/contact/{id} {#ariaid-title3}
Ruft den angegebenen Kontakt Kundenservice-Management (CSM) ab.
### URL-Format
URL mit Versionsnummer: /api/now/{api_version}/contact/{id}
Standard-URL: /api/now/contact/{id}
### Unterstützte Anforderungsparameter
{#contact-GET-id__entry__2}{#contact-GET-id__version-RESTAPI}
| 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 abzurufenden Kontakts. Befindet sich in der Kontakttabelle \[customer_contact\]. |
[Tabelle : 7. Pfadparameter]
{#contact-GET-id__entry__8}
| Name | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 8. Abfrageparameter]
{#contact-GET-id__entry__12}
| Name | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 9. Anforderungstextparameter (XML oder JSON)]
### 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](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#contact-GET-id__entry__16}{#contact-GET-id__accept-RESTAPI}
| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen]
{#contact-GET-id__entry__20}
| Kopfzeile | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 11. Antwortkopfzeilen]
### 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-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#contact-GET-id__entry__24}{#contact-GET-id__entry-200-status-code}{#contact-GET-id__entry-401-status-code}{#contact-GET-id__entry-500-status-code}
| 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 Fall. {#contact-GET-id__ul_ubm_1jl_3v} |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]
### Parameter des Antworttexts (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 „Kontakt" \[customer_contact\] hinzugefügt wurden. Weitere Informationen zu diesen Elementen finden Sie in Ihrer spezifischen Tabellendefinition \[SystemdefinitionTabellen\].
{#contact-GET-id__csmcontact_response_parms__entry__2}{#contact-GET-id__contacttable-account-enrty}{#contact-GET-id__contacttable-active-entry}{#contact-GET-id__contacttable-agent_status-entry}{#contact-GET-id__contacttable-building-entry}{#contact-GET-id__contacttable-calendar_integration-entry}{#contact-GET-id__contacttable-city-entry}{#contact-GET-id__contacttable-company-entry}{#contact-GET-id__contacttable-cost_center-entry}{#contact-GET-id__contacttable-country-entry}{#contact-GET-id__contacttable-date_format-entry}{#contact-GET-id__contacttable-default_perspective-entry}{#contact-GET-id__contacttable-department-entry}{#contact-GET-id__contacttable-edu_status-entry}{#contact-GET-id__contacttable-email-entry}{#contact-GET-id__contacttable-employee_number-entry}{#contact-GET-id__contacttable-enable_multifactor_authn-entry}{#contact-GET-id__contacttable-failed_attempts-entry}{#contact-GET-id__contacttable-first_name-entry}{#contact-GET-id__contacttable-gender-entry}{#contact-GET-id__contacttable-geolocation_tracked-entry}{#contact-GET-id__contacttable-home_phone-entry}{#contact-GET-id__contacttable-internal_integration_user-entry}{#contact-GET-id__contacttable-introduction-entry}{#contact-GET-id__contacttable-last_login-entry}{#contact-GET-id__contacttable-last_login_device-entry}{#contact-GET-id__contacttable-last_login_time-entry}{#contact-GET-id__contacttable-last_name-entry}{#contact-GET-id__contacttable-last_position_update-entry}{#contact-GET-id__contacttable-latitude-entry}{#contact-GET-id__contacttable-ldap_server-entry}{#contact-GET-id__contacttable-location-entry}{#contact-GET-id__contacttable-locked_out-entry}{#contact-GET-id__contacttable-longitude-entry}{#contact-GET-id__contacttable-manager-entry}{#contact-GET-id__contacttable-middle_name-entry}{#contact-GET-id__contacttable-mobile_phone-entry}{#contact-GET-id__contacttable-name-entry}{#contact-GET-id__contacttable-notification-entry}{#contact-GET-id__contacttable-on_schedule-entry}{#contact-GET-id__contacttable-phone-entry}{#contact-GET-id__contacttable-photo-entry}{#contact-GET-id__contacttable-preferred_language-entry}{#contact-GET-id__contacttable-roles-entry}{#contact-GET-id__contacttable-schedule-entry}{#contact-GET-id__contacttable-source-entry}{#contact-GET-id__contacttable-state-entry}{#contact-GET-id__contacttable-street-entry}{#contact-GET-id__contacttable-sys_class_name-entry}{#contact-GET-id__contacttable-sys_created_by-entry}{#contact-GET-id__contacttable-sys_created_on-entry}{#contact-GET-id__contacttable-sys_domain-entry}{#contact-GET-id__contacttable-sys_domain_path-entry}{#contact-GET-id__contacttable-sys_id-entry}{#contact-GET-id__contacttable-sys_mod_count-entry}{#contact-GET-id__contacttable-sys_updated_by-entry}{#contact-GET-id__contacttable-sys_updated_on-entry}{#contact-GET-id__contacttable-time_format-entry}{#contact-GET-id__contacttable-time_sheet_policy-entry}{#contact-GET-id__contacttable-time_zone-entry}{#contact-GET-id__contacttable-title-entry}{#contact-GET-id__contacttable-user_name-entry}{#contact-GET-id__contacttable-vip-entry}{#contact-GET-id__contacttable-web_service_access_only-entry}{#contact-GET-id__contacttable-zip-entry}
| Element | Beschreibung |
|-|-|
| Account | Sys_id des Account-Datensatzes, dem der Kontakt zugeordnet ist; Tabelle „Account \[customer_account\]". Datentyp: Zeichenfolge |
| aktiv | Kennzeichnung, die angibt, ob der Kontakt im System aktiv ist. Mögliche Werte: * wahr: Kontakt ist aktiv * „falsch": Kontakt ist inaktiv Datentyp: Boolesch Standardwert: true |
| agent_status | Status des Service Desk-Mitarbeiters. Mögliche Werte: * Nicht in Arbeit * In Pause * Unterwegs * Am Standort Datentyp: Zeichenfolge Maximale Länge: 40 |
| Gebäude | Sys_id des Datensatzes, der das Gebäude beschreibt, in dem sich der Kontakt befindet Tabelle „Gebäude" \[cmn_building\]. Datentyp: Zeichenfolge |
| calendar_integration | Kalenderanwendung, die der Kontakt verwendet. 1: Outlook Datentyp: Zahl (Ganzzahl) Standard: 1 |
| city | Stadt, in der sich der Kontakt befindet Datentyp: Zeichenfolge Maximale Länge: 40 |
| Unternehmen | Sys_id des Unternehmensdatensatzes, dem der Kontakt zugeordnet ist Tabelle „Unternehmen" \[core_company\]. Datentyp: Zeichenfolge |
| cost_center | Sys_id der Kostenstelle, die dem Kontakt zugeordnet ist Tabelle „Kostenstelle" \[cmn_cost_center\]. Datentyp: Zeichenfolge |
| country | Ländercode des Landes, in dem der Kontakt ansässig ist Datentyp: Zeichenfolge Maximale Länge: 3 |
| date_format | Format, in dem Daten für Kontakte 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) |
| default_perperspektive | Sys_id der Standardperspektive für den Kontakt Befindet sich in der Tabelle „Menüliste" \[sys_peroption\]. Datentyp: Zeichenfolge |
| department | Sys_id der Abteilung, die dem Kontakt zugeordnet ist. Befindet sich in der Tabelle „Abteilung" \[cmn_department\]. Datentyp: Zeichenfolge |
| edu_status | Bildungsstatus des zugeordneten Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Lehrende |
| E-Mail | Kontakt-E-Mail-Adresse. Datentyp: Zeichenfolge |
| employee_number | Mitarbeiternummer des Kontakts. Datentyp: Zeichenfolge |
| enable_multifactor_authn | Kennzeichnung, die angibt, ob eine Multifaktor-Autorisierung erforderlich ist, damit sich der Kontakt beim Serviceportal anmelden kann. Mögliche Werte: * „wahr": Multifaktor-Autorisierung aktiviert * „falsch": Multifaktor-Autorisierung deaktiviert Datentyp: Boolesch Standardwert: false |
| „failed_attempts" | Anzahl der fehlgeschlagenen Anmeldeversuche. Datentyp: Zahl (Ganzzahl) |
| first_name | Vorname des Kontakts Datentyp: Zeichenfolge Maximale Länge: 50 |
| Geschlecht | Kontaktgeschlecht. Datentyp: Zeichenfolge Maximale Länge: 40 |
| geolocation_tracked | Kennzeichnung, die angibt, ob der Kontaktstandort durch Geotracking abgerufen wurde. Mögliche Werte: * true: Durch Geotracking ermittelter Kontaktstandort * „falsch": Kontaktstandort nicht durch Geotracking ermittelt Datentyp: Boolesch Standardwert: falsch |
| home_phone | Private Telefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| internal_integration_user | Kennzeichnung, die angibt, ob der Kontakt ein interner Integrationsbenutzer ist. Mögliche Werte: * true: Interner Integrationsanwender * „false": Anderer Anwendertyp Datentyp: Boolesch Standardwert: false |
| Einführung | Einführung Datentyp: Zeichenfolge Maximale Länge: 40 |
| last_login | Datum, an dem sich der Kontakt zuletzt beim System angemeldet hat. Datentyp: Zeichenfolge (Datum) |
| last_login_device | Gerät, das der Verbraucher bei seiner letzten Anmeldung beim System verwendet hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| last_login_time | Zeitpunkt (Datum und Uhrzeit), zu dem der Kontakt beim System angemeldet wurde. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| last_name | Nachname des Kontakts Datentyp: Zeichenfolge Maximale Länge: 50 |
| last_position_update | Datum und Uhrzeit der Aktualisierung der letzten Position. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| latitude | Breitengradkoordinate des Kontakts Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40 |
| ldap_server | Sys_id des LDAP-Servers, der vom Kontakt zur letzten Anmeldung beim System verwendet wurde; LDAP-Servertabelle \[ldap_server_config\]. Datentyp: Zeichenfolge |
| location | Sys_id des Datensatzes, der den Standort des Kontakts beschreibt; Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| locked_out | Kennzeichnung, die angibt, ob der Kontakt gesperrt ist. Mögliche Werte: * wahr: Kontakt gesperrt * „falsch": Kontakt nicht gesperrt Datentyp: Boolesch Standardwert: false |
| longitude | Längengradkoordinate des Kontakts. Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40 |
| Manager | Sys_id des Datensatzes, die den direkten Vorgesetzten des Kontakts beschreibt; Benutzertabelle \[sys_user\]. Datentyp: Zeichenfolge |
| Middle_name | Zweiter Vorname des Kontakts Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 50 |
| mobile_phone | Mobiltelefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| name | Vollständiger Name des Kontakts Datentyp: Zeichenfolge Maximale Länge: 151 |
| Benachrichtigung | Gibt an, ob der Kontakt Benachrichtigungen erhalten soll. Gültige Werte: * 1: Deaktiviert * 2: Aktiviert Datentyp: Zahl (Ganzzahl) Standardwert: 2 |
| on_schedule | Gibt die Pünktlichkeit des entsandten Servicepersonals an. Gültige Werte: * Ahead: Vor dem Zeitplan. * behind_less30: Hinter Zeitplan, aber weniger als 30 Minuten. * behind_30to60: Hinter dem Zeitplan zwischen 30 und 60 Minuten. * behind_more60: Mehr als 60 Minuten hinter dem Zeitplan. * on_time: Gemäß Zeitplan. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Telefon | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Foto | Foto des Kontakts Datentyp: Bild |
| preferred_language | Ländercode der primären Sprache des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 3 |
| Rollen | Liste der Anwenderrollen, die dem Kontakt zugeordnet sind. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Zeitplan | Sys_id des Datensatzes, der den Arbeitszeitplan für den zugeordneten Kontakt beschreibt; Tabelle „Zeitplan" \[cmn_schedule\]. Datentyp: Zeichenfolge |
| Quelle | Quelle des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Staat | Bundesstaat, in dem sich der Kontakt befindet. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Straße | Straße des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| sys_class_name | Tabelle, die den Kontaktdatensatz enthält. Datentyp: Zeichenfolge Maximale Länge: 80 |
| sys_created_by | Benutzer, der den zugehörigen Kontaktdatensatz ursprünglich erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_created_on | Datum und Uhrzeit der ursprünglichen Erstellung des zugeordneten Kontakts. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| sys_domain | ServiceNow Instanzdomäne des zugeordneten Kontaktdatensatzes. Datentyp: Zeichenfolge |
| sys_domain_path | Pfad der Domäne des Kontaktdatensatzes. Datentyp: Zeichenfolge Maximale Länge: 255 Standard: / (global) |
| sys_id | Eindeutiger Bezeichner für den zugeordneten Kontaktdatensatz. Datentyp: Zeichenfolge |
| sys_mod_count | Anzahl der Male, mit denen der zugeordnete Kontaktdatensatz geändert wurde. Datentyp: Zahl (Ganzzahl) |
| sys_updated_by | Benutzer, der die zugeordneten Kontaktinformationen zuletzt aktualisiert hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_updated_on | Datum und Uhrzeit der Aktualisierung der zugehörigen Kontaktinformationen. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| 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_sheet_policy\] | Sys_id des Datensatzes, der die Zeitnachweisrichtlinie für den zugeordneten Kontakt enthält Tabelle „Zeitnachweisrichtlinie" \[time_sheet_policy\]. Datentyp: Zeichenfolge |
| time_zone | Zeitzone, in der sich der Kontakt befindet, z. B. Kanada/Zentral oder USA/Ost. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Titel | Geschäftsbezeichnung des Kontakts, z. B. Manager, Softwareentwickler oder Auftragnehmer. Datentyp: Zeichenfolge Maximale Länge: 60 |
| user_name | Kontaktbenutzer-ID. Datentyp: Zeichenfolge Maximale Länge: 40 |
| VIP | Kennzeichnung, die angibt, ob der zugeordnete Kontakt einen VIP-Status hat. Mögliche Werte: * wahr: VIP * false: Nicht VIP Datentyp: Boolesch Standardwert: false |
| web_service_access_only | Kennzeichnung, die angibt, ob der Kontakt nur über das Internet auf Services zugreifen kann. Mögliche Werte: * true: Nur Webzugriff * false: Zugriff über alle verfügbaren Methoden Datentyp: Boolesch Standardwert: false |
| Postleitzahl | Postleitzahl des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
[ ]
### cURL-Anforderung
curl "https://instance.servicenow.com/api/now/contact/ddce70866f9331003b3c498f5d3ee417 \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
{
"result": {
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2018-03-10 21:48:11",
"last_login_device": "",
"source": "",
"sys_updated_on": "2019-01-03 05:49:34",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"sys_updated_by": "system",
"enable_multifactor_authn": "false",
"sys_created_on": "2018-03-04 20:26:32",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "admin",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "+1 858 287 7834",
"cost_center": "",
"name": "George Warren",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "george.warren",
"failed_attempts": "",
"edu_status": "",
"latitude": "",
"roles": "",
"title": "Network Administrator",
"sys_class_name": "customer_contact",
"sys_id": "ddce70866f9331003b3c498f5d3ee417",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "+1 858 867 7857",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "George",
"preferred_language": "",
"introduction": "",
"email": "geo.warren@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "3",
"last_name": "Warren",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "25ab8e460a0a0bb300857304ff811af5",
"account": "86837a386f0331003b3c498f5d3ee4ca"
}
}
## Kontakt: POST /now/contact {#ariaid-title4}
Erstellt einen neuen Kundenservice-Management (CSM) -Kontakt.
Darüber hinaus können Sie mit diesem Endpunkt ein Social Media-Profil für den Kontakt erstellen. Um das Profil zu erstellen, müssen Sie die folgenden Parameter im Anforderungstext angeben:
* social_channel
* social_handle
* social_handle_url
{#contact-POST__ul_ntx_lg4_pgb}
Warnung:
Dieser Endpunkt führt keine Parametervalidierung durch, da dies zu einem übermäßigen Overhead führen kann. Wenn ein Anforderungsparameter falsch geschrieben, ungültig oder vom Endpunkt nicht unterstützt wird, wird er ohne Warnung ignoriert.
### URL-Format
URL mit Versionsnummer: /api/now/{api_version}/contact
Standard-URL: /api/now/contact
### Unterstützte Anforderungsparameter
{#contact-POST__entry__2}{#contact-POST__version-RESTAPI}
| 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 : 13. Pfadparameter]
{#contact-POST__entry__6}
| Name | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 14. Abfrageparameter]
{#contact-POST__entry__10}{#contact-POST__contacttable-account-enrty}{#contact-POST__contacttable-active-entry}{#contact-POST__contacttable-agent_status-entry}{#contact-POST__contacttable-building-entry}{#contact-POST__contacttable-calendar_integration-entry}{#contact-POST__contacttable-city-entry}{#contact-POST__contacttable-company-entry}{#contact-POST__contacttable-cost_center-entry}{#contact-POST__contacttable-country-entry}{#contact-POST__contacttable-date_format-entry}{#contact-POST__contacttable-default_perspective-entry}{#contact-POST__contacttable-department-entry}{#contact-POST__contacttable-edu_status-entry}{#contact-POST__contacttable-email-entry}{#contact-POST__contacttable-employee_number-entry}{#contact-POST__contacttable-enable_multifactor_authn-entry}{#contact-POST__contacttable-failed_attempts-entry}{#contact-POST__contacttable-first_name-entry}{#contact-POST__contacttable-gender-entry}{#contact-POST__contacttable-geolocation_tracked-entry}{#contact-POST__contacttable-home_phone-entry}{#contact-POST__contacttable-internal_integration_user-entry}{#contact-POST__contacttable-introduction-entry}{#contact-POST__contacttable-last_login_device-entry}{#contact-POST__contacttable-last_login_time-entry}{#contact-POST__contacttable-last_name-entry}{#contact-POST__contacttable-latitude-entry}{#contact-POST__contacttable-ldap_server-entry}{#contact-POST__contacttable-location-entry}{#contact-POST__contacttable-locked_out-entry}{#contact-POST__contacttable-longitude-entry}{#contact-POST__contacttable-manager-entry}{#contact-POST__contacttable-middle_name-entry}{#contact-POST__contacttable-mobile_phone-entry}{#contact-POST__contacttable-name-entry}{#contact-POST__contacttable-notification-entry}{#contact-POST__contacttable-on_schedule-entry}{#contact-POST__contacttable-phone-entry}{#contact-POST__contacttable-photo-entry}{#contact-POST__contacttable-preferred_language-entry}{#contact-POST__contacttable-roles-entry}{#contact-POST__contacttable-schedule-entry}{#contact-POST__contacttable-source-entry}{#contact-POST__contacttable-state-entry}{#contact-POST__contacttable-street-entry}{#contact-POST__contacttable-time_format-entry}{#contact-POST__contacttable-time_sheet_policy-entry}{#contact-POST__contacttable-time_zone-entry}{#contact-POST__contacttable-title-entry}{#contact-POST__contacttable-user_name-entry}{#contact-POST__contacttable-vip-entry}{#contact-POST__contacttable-web_service_access_only-entry}{#contact-POST__contacttable-zip-entry}
| Element | Beschreibung |
|-|-|
| Account | Sys_id des Account-Datensatzes, dem der Kontakt zugeordnet ist; Tabelle „Account \[customer_account\]". Datentyp: Zeichenfolge |
| aktiv | Kennzeichnung, die angibt, ob der Kontakt im System aktiv ist. Mögliche Werte: * wahr: Kontakt ist aktiv * „falsch": Kontakt ist inaktiv Datentyp: Boolesch Standardwert: true |
| agent_status | Status des Service Desk-Mitarbeiters. Mögliche Werte: * Nicht in Arbeit * In Pause * Unterwegs * Am Standort Datentyp: Zeichenfolge Maximale Länge: 40 |
| Gebäude | Sys_id des Datensatzes, der das Gebäude beschreibt, in dem sich der Kontakt befindet Tabelle „Gebäude" \[cmn_building\]. Datentyp: Zeichenfolge |
| calendar_integration | Kalenderanwendung, die der Kontakt verwendet. 1: Outlook Datentyp: Zahl (Ganzzahl) Standard: 1 |
| city | Stadt, in der sich der Kontakt befindet Datentyp: Zeichenfolge Maximale Länge: 40 |
| Unternehmen | Sys_id des Unternehmensdatensatzes, dem der Kontakt zugeordnet ist Tabelle „Unternehmen" \[core_company\]. Datentyp: Zeichenfolge |
| cost_center | Sys_id der Kostenstelle, die dem Kontakt zugeordnet ist Tabelle „Kostenstelle" \[cmn_cost_center\]. Datentyp: Zeichenfolge |
| country | Ländercode des Landes, in dem der Kontakt ansässig ist Datentyp: Zeichenfolge Maximale Länge: 3 |
| date_format | Format, in dem Daten für Kontakte 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) |
| default_perperspektive | Sys_id der Standardperspektive für den Kontakt Befindet sich in der Tabelle „Menüliste" \[sys_peroption\]. Datentyp: Zeichenfolge |
| department | Sys_id der Abteilung, die dem Kontakt zugeordnet ist. Befindet sich in der Tabelle „Abteilung" \[cmn_department\]. Datentyp: Zeichenfolge |
| edu_status | Bildungsstatus des zugeordneten Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Lehrende |
| E-Mail | Kontakt-E-Mail-Adresse. Datentyp: Zeichenfolge |
| employee_number | Mitarbeiternummer des Kontakts. Datentyp: Zeichenfolge |
| enable_multifactor_authn | Kennzeichnung, die angibt, ob eine Multifaktor-Autorisierung erforderlich ist, damit sich der Kontakt beim Serviceportal anmelden kann. Mögliche Werte: * „wahr": Multifaktor-Autorisierung aktiviert * „falsch": Multifaktor-Autorisierung deaktiviert Datentyp: Boolesch Standardwert: false |
| „failed_attempts" | Anzahl der fehlgeschlagenen Anmeldeversuche. Datentyp: Zahl (Ganzzahl) |
| first_name | Vorname des Kontakts Datentyp: Zeichenfolge Maximale Länge: 50 |
| Geschlecht | Kontaktgeschlecht. Datentyp: Zeichenfolge Maximale Länge: 40 |
| geolocation_tracked | Kennzeichnung, die angibt, ob der Kontaktstandort durch Geotracking abgerufen wurde. Mögliche Werte: * true: Durch Geotracking ermittelter Kontaktstandort * „falsch": Kontaktstandort nicht durch Geotracking ermittelt Datentyp: Boolesch Standardwert: falsch |
| home_phone | Private Telefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| internal_integration_user | Kennzeichnung, die angibt, ob der Kontakt ein interner Integrationsbenutzer ist. Mögliche Werte: * true: Interner Integrationsanwender * „false": Anderer Anwendertyp Datentyp: Boolesch Standardwert: false |
| Einführung | Einführung Datentyp: Zeichenfolge Maximale Länge: 40 |
| last_login_device | Gerät, das der Verbraucher bei seiner letzten Anmeldung beim System verwendet hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| last_login_time | Zeitpunkt (Datum und Uhrzeit), zu dem der Kontakt beim System angemeldet wurde. Datentyp: Zeichenfolge (Datum/Uhrzeit) |
| last_name | Nachname des Kontakts Datentyp: Zeichenfolge Maximale Länge: 50 |
| latitude | Breitengradkoordinate des Kontakts Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40 |
| ldap_server | Sys_id des LDAP-Servers, der vom Kontakt zur letzten Anmeldung beim System verwendet wurde; LDAP-Servertabelle \[ldap_server_config\]. Datentyp: Zeichenfolge |
| location | Sys_id des Datensatzes, der den Standort des Kontakts beschreibt; Tabelle „Standort" \[cmn_location\]. Datentyp: Zeichenfolge |
| locked_out | Kennzeichnung, die angibt, ob der Kontakt gesperrt ist. Mögliche Werte: * wahr: Kontakt gesperrt * „falsch": Kontakt nicht gesperrt Datentyp: Boolesch Standardwert: false |
| longitude | Längengradkoordinate des Kontakts. Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40 |
| Manager | Sys_id des Datensatzes, die den direkten Vorgesetzten des Kontakts beschreibt; Benutzertabelle \[sys_user\]. Datentyp: Zeichenfolge |
| Middle_name | Zweiter Vorname des Kontakts Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 50 |
| mobile_phone | Mobiltelefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| name | Vollständiger Name des Kontakts Datentyp: Zeichenfolge Maximale Länge: 151 |
| Benachrichtigung | Gibt an, ob der Kontakt Benachrichtigungen erhalten soll. Gültige Werte: * 1: Deaktiviert * 2: Aktiviert Datentyp: Zahl (Ganzzahl) Standardwert: 2 |
| on_schedule | Gibt die Pünktlichkeit des entsandten Servicepersonals an. Gültige Werte: * Ahead: Vor dem Zeitplan. * behind_less30: Hinter Zeitplan, aber weniger als 30 Minuten. * behind_30to60: Hinter dem Zeitplan zwischen 30 und 60 Minuten. * behind_more60: Mehr als 60 Minuten hinter dem Zeitplan. * on_time: Gemäß Zeitplan. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Telefon | Geschäftliche Telefonnummer des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Foto | Foto des Kontakts Datentyp: Bild |
| preferred_language | Ländercode der primären Sprache des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 3 |
| Rollen | Liste der Anwenderrollen, die dem Kontakt zugeordnet sind. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Zeitplan | Sys_id des Datensatzes, der den Arbeitszeitplan für den zugeordneten Kontakt beschreibt; Tabelle „Zeitplan" \[cmn_schedule\]. Datentyp: Zeichenfolge |
| Social_Channel | Social Media-Kanal, dem der Kontakt 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-Media-Kanalprofil des Kontakts Datentyp: Zeichenfolge |
| Quelle | Quelle des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Staat | Bundesstaat, in dem sich der Kontakt befindet. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Straße | Straße des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 255 |
| 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_sheet_policy\] | Sys_id des Datensatzes, der die Zeitnachweisrichtlinie für den zugeordneten Kontakt enthält Tabelle „Zeitnachweisrichtlinie" \[time_sheet_policy\]. Datentyp: Zeichenfolge |
| time_zone | Zeitzone, in der sich der Kontakt befindet, z. B. Kanada/Zentral oder USA/Ost. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Titel | Geschäftsbezeichnung des Kontakts, z. B. Manager, Softwareentwickler oder Auftragnehmer. Datentyp: Zeichenfolge Maximale Länge: 60 |
| user_name | Kontaktbenutzer-ID. Datentyp: Zeichenfolge Maximale Länge: 40 |
| VIP | Kennzeichnung, die angibt, ob der zugeordnete Kontakt einen VIP-Status hat. Mögliche Werte: * wahr: VIP * false: Nicht VIP Datentyp: Boolesch Standardwert: false |
| web_service_access_only | Kennzeichnung, die angibt, ob der Kontakt nur über das Internet auf Services zugreifen kann. Mögliche Werte: * true: Nur Webzugriff * false: Zugriff über alle verfügbaren Methoden Datentyp: Boolesch Standardwert: false |
| Postleitzahl | Postleitzahl des Kontakts. Datentyp: Zeichenfolge Maximale Länge: 40 |
[Tabelle : 15. Anforderungstextparameter (XML oder JSON)]
### 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](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#contact-POST__entry__124}{#contact-POST__accept-JSON-only-entry-RESTAPI}{#contact-POST__content_type-JSON-only-entry-RESTAPI}
| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 16. Anforderungskopfzeilen]
{#contact-POST__entry__130}
| Kopfzeile | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 17. Antwortkopfzeilen]
### 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-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#contact-POST__entry__134}{#contact-POST__entry-401-status-code}
| Statuscode | Beschreibung |
|-|-|
| 201 | Neuer Kontaktdatensatz 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. |
[Tabelle : 18. Statuscodes]
### Parameter des Antworttexts (JSON oder XML)
{#contact-POST__entry__144}
| Element | Beschreibung |
|-|-|
| Ergebnis | Sys_id des neu erstellten Kontaktdatensatzes. Datentyp: Zeichenfolge |
[ ]
### cURL-Anforderung
curl -X POST "https://instance.servicenow.com/api/now/contact" \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{ \
"country": "USA", \
"calendar_integration": "1", \
"last_login_time": "2018-03-10 21:48:11", \
"last_login_device": "tablet", \
"building": "Cardinal West", \
"web_service_access_only": "false", \
"notification": "1", \
"enable_multifactor_authn": "true", \
"agent_status": "Travelling", \
"state": "CA", \
"vip": "false", \
"longitude": "123.76", \
"zip": "92069", \
"home_phone": "(555)555-1234", \
"time_format": "hh:mm:ss", \
"geolocation_tracked": "false", \
"active": "true", \
"phone": "+1 858 287 7834", \
"cost_center": "1345", \
"name": "Dora Warren", \
"employee_number": "546", \
"gender": "Female", \
"city": "Orlando", \
"user_name": "dora.warren", \
"failed_attempts": "2", \
"edu_status": "current", \
"latitude": "57.6", \
"title": "Network Administrator", \
"internal_integration_user": "false", \
"ldap_server": "10.24.23.123", \
"mobile_phone": "+1 858 867 7857", \
"street": "123 Lagume", \
"company": "86837a386f0331003b3c498f5d3ee4ca", \
"department": "IT", \
"first_name": "Dora", \
"preferred_language": "Spanish", \
"email": "dora.warren@mailinator.com", \
"manager": "ddce70866f9331003b3c498f5d3ee417", \
"locked_out": "false", \
"last_name": "Warren", \
"middle_name": "Dell", \
"time_zone": "PST", \
"schedule": "9-5", \
"date_format": "MM/DD/YY", \
"location": "25ab8e460a0a0bb300857304ff811af5", \
"account": "86837a386f0331003b3c498f5d3ee4ca" \
}'
--user 'username':'password'
"result": "62fe1c97db76c3006b7a9646db961999"