Account-API

Zürich-API-Referenz

Release

zurich

ft:locale

de-DE

ft:publication_title

Zürich-API-Referenz

ft:clusterId

crapiref

bundleId

crapiref

workflow

Creator

Account-API

Freigeben Version: Zurich

Aktualisiert 31. Juli 2025

11 Minuten Lesedauer

Die Account Die API stellt abzurufende Endpunkte bereit Kundenservice-Management (CSM) Account-Datensätze.

Diese 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.

Account – GET /now/Account

Ruft einen angegebenen Satz von ab Kundenservice-Management (CSM) Accounts.

URL-Format

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

Standard-URL: /api/now/Account

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.
500	Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

Antworttext-Parameter (JSON oder XML)


Parameter	Beschreibung
Account_Code	Eindeutige Kombination von Werten, die eine Anwendung zur Identifizierung von Budgetprognosen und Budgetplänen verwendet. Datentyp: Zeichenfolge Maximale Länge: 255
Account_parent	SYS_ID des übergeordneten Accounts dieses Accounts. Befindet sich in der Tabelle „Account“ [Customer_Account]. Datentyp: Zeichenfolge
Account_path	Pfad vom übergeordneten zu den untergeordneten Accounts in der Accounthierarchie. Datentyp: Zeichenfolge Maximale Länge: 255
Active_Eskalation	SYS_ID der aktiven Eskalation, die dem Account zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Eskalation [sn_customerservice_Eskalation]
apple_icon	Symbol für iPhone-Homepage-Lesezeichen. Datentyp: Bild
Banner_image	Bannerbild, das im Kundenportal angezeigt wird. Datentyp: Bild
Banner_image_light	Kleines Bannerbild. Datentyp: Bild
Banner_Text	Bannertext, der im Kundenportal angezeigt wird. Datentyp: Zeichenfolge Maximale Länge: 4.000
city	Stadt, in der das Unternehmen ansässig ist, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 50
Kontakt	SYS_ID eines Kontaktdatensatzes, der diesem Account zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Benutzer [sys_user]
country	Land, in dem das Unternehmen ansässig ist, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: USA
Kunde	Kennzeichnung, die angibt, ob der Account ein Kundenaccount ist und nicht ein Partneraccount. Mögliche Werte: Wahr: Kundenaccount Falsch: Partner-Account Datentyp: Boolesch Standardwert: false
Rabatt	Rabatt, der dem Account bei Käufen gewährt wird. Datentyp: Zahl Maximale Länge: 15
Fax_Phone	Primäre Faxnummer für das Unternehmen, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 40
fiscal_year	Geschäftsjahr für das Unternehmen, das dem Account zugeordnet ist. Datentyp: Zeichenfolge
Lat_LONG_ERROR	Unterschied des tatsächlichen Standorts im Vergleich zu Breiten- und Längengradinformationen. Datentyp: Zeichenfolge Maximale Länge: 1.000
latitude	Breitengrad des Unternehmens, das diesem Account zugeordnet ist. Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40
longitude	Längengrad des Unternehmens, das diesem Account zugeordnet ist. Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40
manufacturer	Kennzeichnung, die angibt, ob das diesem Account zugeordnete Unternehmen Waren herstellt. Mögliche Werte: Wahr: Stellt Waren her Falsch: Stellt keine Waren her Datentyp: Boolesch Standardwert: false
Market_Cap	Marktwert der öffentlich gehandelten Aktienanteile des zugehörigen Unternehmens. Datentyp: Zahl (Währung) Maximale Länge: 20
name	Name des Unternehmens, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 80
Notizen	Zusätzliche Informationen zum Unternehmen. Datentyp: Zeichenfolge Maximale Länge: 4.000
num_Employees	Anzahl der im Unternehmen beschäftigten Personen. Datentyp: Zahl (Ganzzahl) Maximale Länge: 40
Nummer	Nummer, die diesen Account identifiziert. Datentyp: Zeichenfolge Maximale Länge: 40
übergeordnet	SYS_ID des übergeordneten Accounts dieses Accounts. Datentyp: Zeichenfolge Tabelle: Unternehmen [Core_Company]
Partner	Kennzeichnung, die angibt, ob der Account ein Partner-Account oder ein Kundenaccount ist. Mögliche Werte: Wahr: Partner-Account Falsch: Kundenaccount Datentyp: Boolesch Standardwert: false
Telefon	Primäre Telefonnummer für das Unternehmen. Datentyp: Zeichenfolge
primär	Kennzeichnung, die angibt, ob dies ein primärer Account ist. Mögliche Werte: Wahr: Primärer Account Falsch: Sekundärer Account Datentyp: Boolesch Standardwert: false
Primärer_Kontakt	SYS_ID des primären Kontakts für den Account. Datentyp: Zeichenfolge Tabelle: Kontakt [Customer_contact]
Gewinne	Gewinninformationen, die für dieses Konto eingegeben wurden. Datentyp: Zahl (Währung) Maximale Länge: 40
Public_traded	Kennzeichnung, die angibt, ob das diesem Account zugeordnete Unternehmen öffentlich an der Börse gehandelt wird. Mögliche Werte: Wahr: Öffentlich gehandelt Falsch: Privates Unternehmen Datentyp: Boolesch
Rang_Tier	Typ des Accounts. Mögliche Werte: Schwarze Liste Sonstige Strategisch Taktisch Bewertet Datentyp: Zeichenfolge Maximale Länge: 40
Registrierungscode	Eindeutiger Code, den Kunden verwenden, wenn sie eine Anmeldung im Kundenportal anfordern. Dieser Code bietet eine Methode zum Validieren des Kunden im Unternehmen, bevor Zugriff gewährt wird. Datentyp: Zeichenfolge Maximale Länge: 40
Umsatz_pro_Jahr	Umsatz, der vom Unternehmen generiert wird, das diesem Account zugeordnet ist. Datentyp: Zahl (Währung) Maximale Länge: 20
Status	Bundesland, in dem das Unternehmen ansässig ist. Datentyp: Zeichenfolge Maximale Länge: 40
Stock_price	Preis der Unternehmensaktie. Datentyp: Zeichenfolge Maximale Länge: 40
Stock_Symbol	Aktiensymbol des Unternehmens. Datentyp: Zeichenfolge Maximale Länge: 40
Straße	Straße und Hausnummer des Unternehmens. Datentyp: Zeichenfolge Maximale Länge: 255
sys_class_name	Tabelle, die den zugehörigen Account-Datensatz enthält. Datentyp: Zeichenfolge
sys_created_by	Anwender, der den Account ursprünglich erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40
sys_created_on	Datum und Uhrzeit der ursprünglichen Erstellung des Accounts. Datentyp: Zeichenfolge
sys_id	SYS_ID für den Account-Datensatz. Datentyp: Zeichenfolge
sys_mod_count	Gibt an, wie oft die Account-Informationen aktualisiert wurden. Datentyp: Zahl (Ganzzahl)
sys_updated_by	Anwender, der die Account-Informationen zuletzt geändert hat. Datentyp: Zeichenfolge Maximale Länge: 40
sys_updated_on	Datum und Uhrzeit der letzten Aktualisierung der Account-Informationen. Datentyp: Zeichenfolge
Design	SYS_ID des Kundenportaldesigns, das von diesem Account verwendet wird. Datentyp: Zeichenfolge Tabelle: Design [sys_ui_Theme]
Lieferant	Kennzeichnung, die angibt, ob das diesem Account zugeordnete Unternehmen ein Lieferant ist. Mögliche Werte: Wahr: Lieferant Falsch: Kein Lieferant Datentyp: Boolesch Standardwert: false
vendor_manager	Liste der sys_IDs der Lieferantenmanager für den Account. Datentyp: Zeichenfolge Tabelle: Benutzer [sys_user]
vendor_type	Liste der sys_IDs des Lieferantentyps, z. B. Anwendungen, Hardware, Services oder Software. Datentyp: Zeichenfolge Tabelle: Lieferantentyp [Vendor_type]
Website	URL der Website für das Unternehmen. Datentyp: Zeichenfolge Maximale Länge: 1.024
Postleitzahl	Postleitzahl des Unternehmens. Datentyp: Zeichenfolge Maximale Länge: 40

cURL-Anforderung

curl "https://instance.servicenow.com/api/now/account?sysparm_limit=2&sysparm_offset=2>;rel="next" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

{
"result": [
  {
   "banner_image_light": "",
   "country": "USA",
   "parent": "",
   "notes": "",
   "stock_symbol": "",
   "discount": "",
   "active_escalation": "",
   "sys_updated_on": "2019-01-03 19:37:55",
   "apple_icon": "",
   "number": "ACCT0000003",
    "sys_updated_by": "admin",
    "fiscal_year": "",
    "sys_created_on": "2018-12-23 05:25:17",
    "contact": "",
    "stock_price": "",
    "state": "",
    "banner_image": "",
    "sys_created_by": "admin",
    "longitude": "",
    "zip": "BR1 3QR",
    "profits": "0",
    "phone": "+44 20 8466 9992",
    "fax_phone": "",
    "name": "Boxeo EMEA",
    "banner_text": "",
    "account_code": "~~~~3",
    "primary": "false",
    "city": "Bromley",
    "latitude": "",
    "sys_class_name": "customer_account",
    "manufacturer": "false",
    "account_parent": "86837a386f0331003b3c498f5d3ee4ca",
    "sys_id": "3eedd08413651200042ab3173244b088",
    "market_cap": "0",
    "num_employees": "",
    "rank_tier": "",
    "street": "18 London Rd",
    "vendor": "false",
    "lat_long_error": "",
    "theme": "",
    "vendor_type": "",
    "website": "",
    "revenue_per_year": "0",
    "publicly_traded": "false",
    "sys_mod_count": "5",
    "sys_tags": "",
    "partner": "false",
    "registration_code": "BOXEO-EMEA",
    "vendor_manager": "",
    "account_path": "~~~~1/~~~~3",
    "primary_contact": "ff66c1254fb81200025ba3618110c76e",
    "customer": "true"
  },
  {
    "banner_image_light": "",
    "country": "USA",
    "parent": "",
    "notes": "",
    "stock_symbol": "",
    "discount": "",
    "active_escalation": "",
    "sys_updated_on": "2019-01-03 19:38:04",
    "apple_icon": "",
    "number": "ACCT0000004",
    "sys_updated_by": "admin",
    "fiscal_year": "",
    "sys_created_on": "2018-12-23 05:19:24",
    "contact": "",
    "stock_price": "",
    "state": "",
    "banner_image": "",
    "sys_created_by": "admin",
    "longitude": "",
    "zip": "V5L 2G4",
    "profits": "0",
    "phone": "+1 604-255-9797",
    "fax_phone": "",
    "name": "Boxeo Canada",
    "banner_text": "",
    "account_code": "~~~~4",
    "primary": "false",
    "city": "Vancouver",
    "latitude": "",
    "sys_class_name": "customer_account",
    "manufacturer": "false",
    "account_parent": "86837a386f0331003b3c498f5d3ee4ca",
    "sys_id": "609cd80413651200042ab3173244b03e",
    "market_cap": "0",
    "num_employees": "",
    "rank_tier": "",
    "street": "1362 Venables St,, BC V5L 2G4, Canada",
    "vendor": "false",
    "lat_long_error": "",
    "theme": "",
    "vendor_type": "",
    "website": "",
    "revenue_per_year": "0",
    "publicly_traded": "false",
    "sys_mod_count": "5",
    "sys_tags": "",
    "partner": "false",
    "registration_code": "BOXEO-CANADA",
    "vendor_manager": "",
    "account_path": "~~~~1/~~~~4",
    "primary_contact": "c07424a54f781200025ba3618110c746",
    "customer": "true"
  }
 ]
}

Account – GET /now/Account/{ID}

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