---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Erstellen Sie eine geskriptete REST-API

# Erstellen Sie eine geskriptete REST-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Erstellen Sie eine geskriptete REST-API, um Webservice-Endpunkte zu definieren.

## Vorbereitungen

Erforderliche Rolle: web_service_admin

## Warum und wann dieser Vorgang ausgeführt wird

Standardmäßig enthalten geskriptete REST-APIs eine ACL, die Anwender mit der Rolle „snc_external" daran hindert, Anforderungen an die API zu stellen.

## Prozedur

1. Navigieren zu AlleSystem-WebservicesScripted REST APIsan.
2. Klicken Sie auf Neu.
3. Geben Sie ein Name Für den Service.  
   Die API-ID Wird automatisch basierend auf festgelegt Name . Sie können ändern API-ID Falls erforderlich.
4. Klicken Sie auf Absenden.
{#t_CreateAScriptedRESTService__steps_nmg_dld_cs}

## Nächste Maßnahme

Nachdem Sie die API erstellt haben, konfigurieren Sie den Service nach Bedarf, z. B. indem Sie Ressourcen erstellen, ACLs zuweisen oder unterstützte Anforderungs- und Antwortformate angeben.
* **[Erstellen Sie eine geskriptete REST-API-Ressource](https://servicenow-prod.fluidtopics.net/J9poRY8S~x2OKdHpaThv6Q)**   
  Erstellen Sie eine geskriptete REST-API-Ressource, um die HTTP-Methode und das Verarbeitungsskript zu definieren und Einstellungen aus dem übergeordneten Service zu überschreiben.
* **[Definieren Sie geskriptete REST-API-Header](https://servicenow-prod.fluidtopics.net/3pYW1yQsqkw5HrPWiClXsQ)**   
  Definieren Sie geskriptete REST-API-Header, um zu steuern, welche Header die API akzeptiert und mit denen antworten kann.
* **[Definieren Sie verfügbare Abfrageparameter](https://servicenow-prod.fluidtopics.net/4uWf9lG7q7tnJRfDGt0Q3Q)**   
  Definieren Sie verfügbare Abfrageparameter, um zu steuern, welche Werte ein anfordernder Anwender im Anforderungs-URI übergeben kann.
* **[Ordnen Sie Abfrageparameter einer Ressource zu](https://servicenow-prod.fluidtopics.net/e1~14hZGXtE2lG_gKvIEQw)**   
  Ordnen Sie geskriptete REST-API-Abfrageparameter einer Ressource zu.
* **[Konfigurieren Sie eine geskriptete REST-API, um eine ACL zu erfordern](https://servicenow-prod.fluidtopics.net/zQtfX_l3OFHSIYU96o18zQ)**   
  Anforderungen an geskriptete REST-APIs berücksichtigen Plattform-ACLs, und der anfordernde Anwender muss alle Tabellen-ACL-Anforderungen erfüllen, um auf Instanzdaten zuzugreifen. Darüber hinaus können Sie die geskriptete REST-API so konfigurieren, dass eine bestimmte ACL erforderlich ist.
* **[Aktivieren Sie die Versionsverwaltung für eine geskriptete REST-API](https://servicenow-prod.fluidtopics.net/p8BHlxXQwYGEhWK7Y7vxCA)**   
  Aktivieren Sie die Versionsverwaltung für eine geskriptete REST-API, um mehrere Versionen der API bereitzustellen und gleichzeitig die Kompatibilität mit vorhandenen Integrationen beizubehalten.
* **[Inhaltstyp für Kontrollanforderung und -Antwort](https://servicenow-prod.fluidtopics.net/_mGsifV2rKETGH6I987KxQ)**   
  Steuert, welche Inhaltstypen in geskripteten REST-API-Anforderungen und -Antworten zulässig sind.
* **[Maximale Anforderungsgröße wird gesteuert](https://servicenow-prod.fluidtopics.net/iJoJyp2uMWD8mcAH0Ssw9w)**   
  Sie können die maximale Dateigröße angeben, die in einer geskripteten REST-API-Anforderungsnutzlast zulässig ist.

