HTTP-Anforderungen erstellen und Fehler behandeln

Artikel
10/05/2023

Sie interagieren mit der Web-API, indem Sie HTTP-Anforderungen erstellen und senden. Sie müssen wissen, wie die entsprechenden HTTP-Kopfzeilen festgelegt werden, und auf mögliche Fehler in der Antwort reagieren.

Web-API-URL und Versionen

So finden Sie die Web-API-URL für Ihre Umgebung:

Melden Sie sich bei Power Apps an und wählen Sie dann Ihre Umgebung in der oberen rechten Ecke.
Wählen Sie die Schaltfläche Einstellungen in der oberen rechten Ecke und wählen Sie dann Entwickler-Ressourcen.

Von hier aus können Sie den Wert für den Web-API-Endpunkt kopieren. Weitere Informationen: Entwicklerressourcen anzeigen und verwalten

In der folgenden Tabelle werden die Teile der URL beschrieben:

Komponente	Beschreibung des Dataflows
Protokoll	`https://`
Umgebungsname	Der eindeutige Name, der für Ihre Umgebung gilt. Wenn Ihr Firmennamen Contoso ist, kann er `contoso` sein.
Region	Ihre Umgebung ist in der Regel in einem Rechenzentrum in Ihrer Nähe verfügbar. Für Nordamerika ist es `crm`. Für Südamerika `crm2`, für Japan `crm7`. Die vollständige Liste finden Sie unter Rechenzentrumsregionen
Basis-URL	Dies ist normalerweise `dynamics.com.`, aber einige Rechenzentren verwenden andere Werte. Siehe Datacenter-Regionen.
Web-API-Pfad	Der Pfad zur Web-API ist `/api/data/`.
Version	Die Version wird auf folgende Weise ausgedrückt: `v[Major_version].[Minor_version][PatchVersion]/`. Die aktuelle Version ist `v9.2`.
Ressource	`EntitySetName` der Tabelle oder der Name der Funktion oder Aktionen, die Sie verwenden möchten.

Die URL, die Sie verwenden, setzt sich aus diesen Teilen zusammen:

Protokoll + Umgebungsname + Region + Basis-URL + Web-API-Pfad + Version + Ressource.

Maximale URL-Länge

Die maximal akzeptierte Länge der URL beträgt 32 KB (32.768 Zeichen). Dies sollte für die meisten Arten von Anforderungen ausreichend sein, mit Ausnahme bestimmter GET-Vorgänge, die Abfrageparameter mit sehr langen Zeichenfolgen erfordern, z. B. Abfragen mit FetchXML. Wenn Sie Anfragen innerhalb des Hauptteils einer $batch-Anforderung senden, können Sie Anforderungen mit URLs von bis zu 64 KB (65.536 Zeichen) senden. Erfahren Sie mehr über das Senden von FetchXML innerhalb einer $batch-Anforderung.

Versionskompatibilität

Diese Version führt Funktionen ein, die in älteren Versionen nicht verfügbar sind. Nachfolgende Unterversionen können weitere Funktionalitäten bieten, die nicht rückwirkend zu früheren Unterversionen hinzugefügt werden. Ihr für v9.0 geschriebener Code funktioniert auch in zukünftigen Versionen, wenn Sie in Ihrer URL auf v9.0 verweisen.

Sobald neue Funktionen eingeführt werden, können sie mit früheren Versionen kollidieren. Diese Breaking Changes sind erforderlich, um den Dienst besser zu machen. Meistens bleiben Funktionen identisch zwischen Versionen, aber Sie sollten darauf nicht zählen, dass sie so bleiben werden.

Hinweis

Im Gegensatz zu den Nebenversionen von v8.x werden neue Funktionalitäten oder andere Änderungen, die in zukünftigen Versionen hinzugefügt werden, nicht auf frühere Versionen angewendet. Achten Sie auf die Version des von Ihnen verwendeten Dienstes und testen Sie Ihren Code, wenn Sie die verwendete Version ändern.

HTTP-Methoden

In der folgenden Tabelle sind die HTTP-Methoden aufgeführt, die Sie mit der Dataverse Web-API verwenden können.

Methode	Verbrauch
`GET`	Wird verwendet, wenn Daten inkl. aufrufender Funktionen abgerufen werden. Der erwartete Statuscode für einen erfolgreichen Abruf ist `200 OK`.
`POST`	Wird verwendet wenn Entitäten erstellt oder Aktionen aufgerufen werden.
`PATCH`	Wird verwendet, wenn Entitäten aktualisiert werden oder Upsert Vorgänge ausgeführt werden.
`DELETE`	Wir verwendet, wenn Entitäten oder Einzelpersoneneigenschaften gelöscht werden.
`PUT`	Verwendung in bestimmten Fällen zur Aktualisierung einzelner Eigenschaften von Entitäten. Diese Methode wird nicht empfohlen, wenn die meisten Entitäten aktualisiert werden. Verwenden Sie `PUT`, wenn Sie Tabellendefinitionen aktualisieren. Mehr Informationen: Verwenden Sie die Web-API mit Tabellendefinitionen

HTTP-Kopfzeilen

Alle HTTP-Anforderungen sollten mindestens die folgenden Header enthalten.

Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null

Obwohl das OData-Protokoll sowohl das JSON- als auch ATOM-Format zulässt, unzerstützt die Web-API nur JSON. Jede Anfrage sollte den Accept-Kopfzeilenwert von application/json beinhalten, auch wenn keine Antwort erwartet wird. Jeder in der Antwort zurückgegebene Fehler wird als JSON zurückgegeben. Auch wenn Ihr Code verwendet werden kann, wenn die Kopfzeile nicht enthalten ist, sollten Sie sie im Rahmen der bewährten Methoden einschließen.

Die aktuelle OData-Version ist 4.0, aber zukünftige Versionen werden die Möglichkeit bieten neue Funktionen zu verwenden. Um sicherzustellen, dass es keine Mehrdeutigkeit über die OData-Version gibt, die in Zukunft auf Ihren Code angewendet wird, sollten Sie immer die aktuelle OData-Version sowie die maximale Version für den Code in einer expliziten Anweisung angeben. Verwenden Sie beide OData-Version- und OData-MaxVersion-Header, die auf den Wert 4.0 festgelegt sind.

Abfragen, die Navigationseigenschaften mit Sammlungswert erweitern, geben möglicherweise zwischengespeicherte Daten für solche Eigenschaften zurück, die die letzten Änderungen nicht widerspiegeln. Fügen Sie If-None-Match: null-Kopfzeile im Anforderungstext, um Browserzwischenspeicher der Web-API-Anforderung zu überschreiben. Weitere Informationen: Hypertext Transfer Protocol (HTTP/1.1): Bedingte Anforderungen 3.2 : If-None-Match.

Jede Anfrage, die JSON-Daten im Anforderungstext enthält, muss einen Content-Type-Header mit einem Wert von application/json beinhalten.

Content-Type: application/json

Sie können andere Kopfzeilen verwenden, um bestimmte Funktionen zu aktivieren.

Prefer-Header

Sie können den Prefer-Header mit den folgenden Werten verwenden, um Einstellungen anzugeben.

Prefer-Wert	Beschreibung des Dataflows
`return=representation`	Verwenden Sie die Voreinstellung, um Daten für Erstellen- (`POST`) oder Aktualisieren (`PATCH`)-Vorgänge für Entitäten zurückzugeben. Wenn diese Einstellung auf eine `POST`-Anforderung angewendet wird, hat eine erfolgreiche Antwort den Status `201 Created`. Bei einer `PATCH`-Anforderung hat eine erfolgreiche Antwort den Status `200 OK.` Ohne diese angewendete Einstellung haben beide Vorgänge den Status `204 No Content`, um anzuzeigen, dass standardmäßig keine Daten im Textteil der Antwort zurückgegeben werden. Weitere Informationen: Mithilfe zurückgegebener Daten erstellen & Mit zurückgegebenen Daten erstellen
`odata.include-annotations`	Siehe Anmerkungen anfordern
`odata.maxpagesize`	Verwenden Sie diese Einstellung, um anzugeben, wie viele Seiten Sie in einer Abfrage zurückgeben möchten. Weitere Informationen: Seite Ergebnisse
`odata.track-changes`	Mit der Änderungsnachverfolgungsfunktion können die Daten effizient synchronisiert werden, indem festgestellt wird, welche Daten geändert wurden, nachdem die Daten ursprünglich extrahiert oder zuletzt synchronisiert wurden. Weitere Informationen: Verwenden der Änderungsnachverfolgung zum Synchronisieren von Daten mit externen Systemen
`respond-async`	Gibt an, dass die Anforderung asynchron verarbeitet werden sollte. Weitere Informationen: Hintergrundvorgänge (Vorschau)

Hinweis

Mehrere Prefer-Header können mit durch Komma getrennten Werten angegeben werden, zum Beispiel: Prefer: respond-async,odata.include-annotations="*"

Anmerkungen anfordern

Sie können mit dem Prefer: odata.include-annotations Request-Header verschiedene OData-Anmerkungsdaten anfordern, die mit den Ergebnissen zurückgegeben werden sollen. Sie können alle Anmerkungen zurückgeben oder bestimmte Anmerkungen angeben. Die folgende Tabelle beschreibt die Anmerkungen, die die Dataverse Web-API unterstützt:

Anmerkung	Beschreibung
`OData.Community.Display.V1.FormattedValue`	Gibt formatierte Zeichenfolgenwerte zurück, die Sie in Ihrer Anwendung verwenden können. Weitere Informationen: Formatierte Werte
`Microsoft.Dynamics.CRM.associatednavigationproperty` `Microsoft.Dynamics.CRM.lookuplogicalname`	Gibt Informationen zu verwandten Nachschlagespalten zurück. Weitere Informationen: Suche Dateneigenschaft
`Microsoft.Dynamics.CRM.totalrecordcount` `Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded`	Wenn Sie die Abfrageoption `$count` verwenden, gibt die Anmerkung `@odata.count` die Anzahl der Datensätze an, es können jedoch nur 5000 Datensätze gleichzeitig zurückgegeben werden. Fordern Sie `Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded` an, um einen booleschen Wert zu erhalten, der Ihnen mitteilt, ob die Gesamtzahl der Datensätze, die mit der Abfrage übereinstimmen, 5000 überschreitet. Weitere Informationen: Zeilenzahl zählen
`Microsoft.Dynamics.CRM.globalmetadataversion`	Diese Anmerkung wird bei der Anfrage zurückgegeben und Sie können sie in Ihrer Anwendung zwischenspeichern. Der Wert ändert sich, wenn sich das Schema ändert, was bedeutet, dass Sie eventuell die Schemadaten, die Ihre Anwendung zwischengespeichert hat, aktualisieren müssen. Weitere Informationen: Cache-Schemadaten
`Microsoft.PowerApps.CDS.ErrorDetails.OperationStatus` `Microsoft.PowerApps.CDS.ErrorDetails.SubErrorCode` `Microsoft.PowerApps.CDS.HelpLink` `Microsoft.PowerApps.CDS.TraceText` `Microsoft.PowerApps.CDS.InnerError.Message`	Diese Anmerkungen liefern mehr Details, wenn Fehler zurückgegeben werden. Mehr Informationen: Mehr Details bei Fehlern hinzufügen

Wenn Sie nur bestimmte Anmerkungen wünschen, können Sie diese als kommagetrennte Werte anfordern. Sie können auch das Zeichen „*“ als Platzhalter verwenden. Beispielsweise enthält der folgende Prefer Anforderungsheader nur die formatierten Werte und alle zusätzlichen Anmerkungen zu Fehlerdetails:

Prefer: odata.include-annotations="OData.Community.Display.V1.FormattedValue,Microsoft.PowerApps.CDS.ErrorDetails*"

Tipp

Es ist allgemein üblich, einfach den Anfrage-Header Prefer: odata.include-annotations="*" zu verwenden, um alle Anmerkungen zurückzugeben.

Andere Header

Header	Wert	Beschreibung
`CallerObjectId`	Microsoft Entra ID-Objekt-ID des Benutzers	Verwenden Sie diesen Header, um sich als ein anderer Benutzer auszugeben, wenn der Aufrufer über die entsprechenden Rechte verfügt. Legen Sie den Wert auf die Microsoft Entra ID-Objekt-ID des Benutzers fest, in dessen Identität gewechselt werden soll. Diese Daten befinden sich in der Benutzer (SystemUser)-Tabelle/Entität AzureActiveDirectoryObjectId Attribut (Spalte). Weitere Informationen: Sich für mit Web-API ein anderes Benutzerkonto ausgeben
`If-Match`	`Etag`-Wert oder `*`	Verwenden Sie diesen Header, um optimistische Parallelität anzuwenden, um sicherzustellen, dass Sie keine Änderungen überschreiben, die jemand anderes auf dem Server vorgenommen hat, seit Sie einen Datensatz abgerufen haben. Weitere Informationen: Optimistische Gleichzeitigkeit anwenden und If-Match Sie können diesen Header auch mit `*` verwenden, um zu verhindern, dass ein `PATCH`-Vorgang einen Datensatz erstellt. Weitere Informationen: Das Erstellen von Upsert verhindern
`If-None-Match`	`null` oder `*`	Dieser Header sollte wie in HTTP-Header beschrieben in allen Anfragen mit einem Wert von `null` verwendet werden, aber es kann auch verwendet werden, um einen `POST`-Vorgang von der Durchführung eines Updates zu verhindern. Weitere Informationen: Aktualisierung bei Upsert verhindern und If-None-Match
`MSCRM.SolutionUniqueName`	eindeutiger Name der Lösung	Verwenden Sie diesen Header, wenn Sie eine Lösungskomponente erstellen und sie einer nicht verwalteten Lösung zuordnen möchten. Weitere Informationen: Erstellen und Aktualisieren von Tabellendefinitionen mit der Web-API
`MSCRM.SuppressDuplicateDetection`	`false`	Verwenden Sie diesen Header mit dem Wert `false` um Duplikaterkennung beim Erstellen oder Aktualisieren eines Datensatzes zu aktivieren. Weitere Informationen: Suchen nach Duplikaten
`MSCRM.BypassCustomPluginExecution`	`true`	Verwenden Sie diesen Header, wenn Sie benutzerdefinierten Plugin-Code umgehen wollen und der Aufrufer das `prvBypassCustomPlugins`-Recht hat. Mehr Informationen: Benutzerdefinierte Geschäftslogik umgehen
`Consistency`	`Strong`	Verwenden Sie diesen Header, wenn Sie über die neueste Version eines zwischengespeicherten Elements verfügen müssen. Zu den zwischengespeicherten Artikeln gehören Metadatendefinitionen, Labels, Benutzer- und Teamberechtigungen. Wenn Sie beispielsweise eine Änderung an einer Metadatendefinition, Bezeichnung oder Berechtigung anwenden und Code haben, der die neueste Definition innerhalb von 30 Sekunden nach der Änderung verwenden muss, verwenden Sie diesen Header, um sicherzustellen, dass Sie die neueste Version erhalten. Die Verwendung dieses Headers führt zu einer kleinen Leistungseinbuße, daher sollte er nicht ständig verwendet werden.

Wenn Sie Batchvorgänge ausführen, müssen Sie in der Anforderung viele verschiedene Kopfzeilen anwenden sowie für jeden Teil, in dem der Text gesendet wird. Weitere Informationen: Ausführen von Batchvorgängen mit der Web-API.

Ermitteln von Statuscodes

Ob eine HTTP-Anforderung erfolgreich war oder nicht, die Antwort enthält einen Statuscode. Die folgende Tabelle beschreibt die Statuscodes, die von der Microsoft Dataverse Web-API zurückgegeben werden.

Code	Beschreibung	Type
`200 OK`	Erwarten Sie diesen Statuscode, wenn Ihr Vorgang Daten im Antworttext zurückgibt.	Erfolg
`201 Created`	Erwarten Sie diesen Statuscode, wenn Ihr Entitäts-POST-Vorgang erfolgreich ist und Sie die `return=representation`-Einstellung in der Anforderung angegeben haben.	Erfolg
`204 No Content`	Erwarten Sie diesen Statuscode, wenn der Vorgang erfolgreich durchgeführt wird, jedoch keine Daten im Antworttext zurückgegeben werden.	Erfolg
`304 Not Modified`	Erwarten Sie diesen Statuscode beim Testen, ob eine Entität seit dem letzten Abruf geändert wurde. Weitere Informationen: Bedingte Abrufe.	Umleitung
`403 Forbidden`	Erwarten Sie diesen Statuscode für die folgenden Fehlertypen: - `AccessDenied` - `AttributePermissionReadIsMissing` - `AttributePermissionUpdateIsMissingDuringUpdate` - `AttributePrivilegeCreateIsMissing` - `CannotActOnBehalfOfAnotherUser` - `CannotAddOrActonBehalfAnotherUserPrivilege` - `CrmSecurityError` - `InvalidAccessRights` - `PrincipalPrivilegeDenied` - `PrivilegeCreateIsDisabledForOrganization` - `PrivilegeDenied` - `unManagedinvalidprincipal` - `unManagedinvalidprivilegeedepth`	Client-Fehler
`401 Unauthorized`	Erwarten Sie diesen Statuscode für die folgenden Fehlertypen: - `BadAuthTicket` - `ExpiredAuthTicket` - `InsufficientAuthTicket` - `InvalidAuthTicket` - `InvalidUserAuth` - `MissingCrmAuthenticationToken` - `MissingCrmAuthenticationTokenOrganizationName` - `RequestIsNotAuthenticated` - `TamperedAuthTicket` - `UnauthorizedAccess` - `UnManagedInvalidSecurityPrincipal`	Client-Fehler
`413 Payload Too Large`	Erwarten Sie diesen Statuscode, wenn die Anforderung zu lang ist.	Client-Fehler
`400 BadRequest`	Erwarten Sie diesen Statuscode, wenn ein Argument ungültig ist.	Client-Fehler
`404 Not Found`	Erwarten Sie diesen Statuscode, wenn die Ressource nicht vorhanden ist.	Client-Fehler
`405 Method Not Allowed`	Dieser Fehler tritt für falsche Methoden und Ressourcenkombinationen auf. Beispielsweise können Sie weder DELETE noch PATCH bei einer Sammlung von Entitäten verwenden. Folgendes für die folgenden Fehlertypen annehmen: - `CannotDeleteDueToAssociation` - `InvalidOperation` - `NotSupported`	Client-Fehler
`412 Precondition Failed`	Erwarten Sie diesen Statuscode für die folgenden Fehlertypen: - `ConcurrencyVersionMismatch` - `DuplicateRecord`	Client-Fehler
`429 Too Many Requests`	Erwarten Sie diesen Statuscode, wenn API-Begrenzungen überschritten werden. Für weitere Informationen gehen Sie zu: API-Grenzwerte für den Serviceschutz	Client-Fehler
`501 Not Implemented`	Erwarten Sie diesen Statuscode, wenn ein angeforderter Vorgang nicht implementiert wird.	Serverfehler
`503 Service Unavailable`	Erwarten Sie diesen Statuscode, wenn der Web-API-Service nicht verfügbar ist.	Serverfehler

Analysefehler von der Antwort

Details zu Fehlern sind als JSON in der Antwort im folgenden Format enthalten.

{  
 "error":{  
  "code": "<This code is not related to the http status code and is frequently empty>",  
  "message": "<A message describing the error>"  
 }  
}

Weitere Details mit Fehlern einschließen

Einige Fehler können mithilfe von Anmerkungen weitere Details enthalten. Wenn eine Anfrage den Header Prefer: odata.include-annotations="*" enthält, enthält die Antwort alle Anmerkungen, die weitere Details zu Fehlern enthalten, sowie eine URL, die Sie zu einer speziellen Anleitung für den Fehler führen kann.

Einige dieser Details können von Entwicklern durch das Schreiben von Plug-Ins festgelegt werden. Angenommen, Sie haben ein Plug-In, das mithilfe des InvalidPluginExecutionException (OperationStatus, Int32, String)-Constructors einen Fehler auslöst. Mit diesem Konstruktor können Sie einen OperationStatus-Wert, einen benutzerdefinierten Integer-Fehlercode und eine Fehlermeldung übergeben.

Eine einfaches Plug-In könnte so aussehen:

namespace MyNamespace
{
    public class MyClass : IPlugin
    {
        public void Execute(IServiceProvider serviceProvider)
        {

            // Obtain the tracing service
            ITracingService tracingService =
            (ITracingService)serviceProvider.GetService(typeof(ITracingService));

            tracingService.Trace("Entering MyClass plug-in.");

             try
            {
                throw new InvalidPluginExecutionException(OperationStatus.Canceled, 12345, "Example Error Message.");
            }
            catch (InvalidPluginExecutionException ex)
            {
                tracingService.Trace("StackTrace:");
                tracingService.Trace(ex.StackTrace);
                throw ex;
            }
        }
    }
}

Wenn dieses Plugin für die Nachricht „Erstellen“ einer Entität „Konto“ registriert ist und die Anfrage zum Erstellen eines Kontos die Präferenz odata.include-annotations="*" enthält, sehen Anfrage und Antwort wie im folgenden Beispiel aus:

Anforderung:

POST https://yourorg.api.crm.dynamics.com/api/data/v9.1/accounts HTTP/1.1
Content-Type: application/json;
Prefer: odata.include-annotations="*"
{
    "name":"Example Account"
}

Antwort:

HTTP/1.1 400 Bad Request
Content-Type: application/json; odata.metadata=minimal
{
    "error": {
        "code": "0x80040265",
        "message": "Example Error Message.",
        "@Microsoft.PowerApps.CDS.ErrorDetails.OperationStatus": "1",
        "@Microsoft.PowerApps.CDS.ErrorDetails.SubErrorCode": "12345",
        "@Microsoft.PowerApps.CDS.HelpLink": "http://go.microsoft.com/fwlink/?LinkID=398563&error=Microsoft.Crm.CrmException%3a80040265&client=platform",
        "@Microsoft.PowerApps.CDS.TraceText": "\r\n[MyNamespace: MyNamespace.MyClass ]\r\n[52e2dbb9-85d3-ea11-a812-000d3a122b89: MyNamespace.MyClass : Create of account] \r\n\r\n Entering MyClass plug-in.\r\nStackTrace:\r\n   at MyNamespace.MyClass.Execute(IServiceProvider serviceProvider)\r\n\r\n"
        "@Microsoft.PowerApps.CDS.InnerError.Message": "Example Error Message."
    }
}

Die folgende Tabelle beschreibt die Anmerkungen in der Antwort.

Anmerkung und Beschreibung	Wert
`@Microsoft.PowerApps.CDS.ErrorDetails.OperationStatus` Der Wert von OperationStatus, der vom InvalidPluginExecutionException (OperationStatus, Int32, String)-Constructor festgelegt wird.	`1`
`@Microsoft.PowerApps.CDS.ErrorDetails.SubErrorCode` Der Wert von `SubErrorCode`, der vom InvalidPluginExecutionException (OperationStatus, Int32, String)-Constructor festgelegt wird.	`12345`
`@Microsoft.PowerApps.CDS.HelpLink` Eine URL, die Informationen zu dem Fehler enthält, der Sie möglicherweise zu einer Anleitung zur Behebung des Fehlers weiterleitet.	`http://go.microsoft.com/fwlink/?LinkID=398563&error=Microsoft.Crm.CrmException%3a80040265&client=platform`
`@Microsoft.PowerApps.CDS.TraceText` Inhalt, der mit der ITracingService.Trace(String, Object[]) Methode in das Protokoll des Plug-ins geschrieben wird. Diese Anmerkung enthält den Stacktrace für das Plug-in, da der Autor des Plug-ins ihn protokolliert hat.	`[MyNamespace: MyNamespace.MyClass ]` `[52e2dbb9-85d3-ea11-a812-000d3a122b89: MyNamespace.MyClass :Create of account]` `Entering MyClass plug-in.` `StackTrace:` `at MyNamespace.MyClass.Execute(IServiceProvider serviceProvider)`
`@Microsoft.PowerApps.CDS.InnerError.Message` Die in InnerError für die Ausnahme gefundene Fehlermeldung. Diese Meldung sollte mit der Fehlermeldung identisch sein, außer in bestimmten Sonderfällen, die nur für den internen Gebrauch bestimmt sind.	`Example Error Message.`

Hinweis

Die @Microsoft.PowerApps.CDS.HelpLink ist keine Garantie dafür, dass Sie für jeden Fehler eine Anleitung erhalten. Die Anleitung kann proaktiv bereitgestellt werden, aber meistens wird sie reaktiv bereitgestellt, je nachdem, wie häufig der Link verwendet wird. Verwenden Sie den Link. Er stellt keine Anleitung bereit. Ihre Verwendung des Links hilft uns dabei, festzustellen, dass mehr Personen Anleitung bei dem Fehler benötigen. Wir können dann Prioritäten für die Anleitungen zu Fehlern setzen, bei den Personen am meisten Hilfe benötigen. Die Ressourcen, auf die der Link Sie möglicherweise verweist, können Dokumentation, Links zu Community-Ressourcen oder externe Websites sein.

Wenn Sie nicht alle Anmerkungen in der Antwort erhalten möchten, können Sie angeben, welche Anmerkungen Sie zurückgegeben haben möchten. Anstatt Prefer: odata.include-annotations="*" zu verwenden, können Sie den folgenden Wert verwenden, um nur formatierte Werte für Vorgänge zu erhalten, die Daten und den Hilfe-Link abrufen, wenn ein Fehler auftritt: Prefer: odata.include-annotations="OData.Community.Display.V1.FormattedValue,Microsoft.PowerApps.CDS.HelpLink".

Weitere Informationen: Anforderungsanmerkungen

Eine gemeinsame Variable aus der Web-API hinzufügen

Sie können einen Zeichenfolgenwert festlegen, der für Plug-Ins im ExecutionContext in der SharedVariables-Sammlung verfügbar ist. Weitere Informationen:

Siehe auch

Vorgänge mithilfe der Web-API ausführen
Abfrage von Daten über die Web-API
Erstellen einer Tabellenzeile über die Web-API
Abrufen einer Tabellenzeile über die Web-API
Aktualisieren und Löschen von Tabellenzeilen über die Web-API
Zuordnen und Aufheben der Zuordnung von Tabellenzeilen über die Web-API
Nutzen von Web-API-Funktionen
Nutzen von Web-API-Aktionen
Ausführen von Batchbetrieben mithilfe der Web-API
Annehmen eines anderen Benutzerkontos mit Web API
Bedingte Vorgänge mithilfe der Web-API ausführen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).

HTTP-Anforderungen erstellen und Fehler behandeln

Web-API-URL und Versionen

Maximale URL-Länge

Versionskompatibilität

HTTP-Methoden

HTTP-Kopfzeilen

Prefer-Header

Anmerkungen anfordern

Andere Header

Ermitteln von Statuscodes

Analysefehler von der Antwort

Weitere Details mit Fehlern einschließen

Eine gemeinsame Variable aus der Web-API hinzufügen

Siehe auch

Feedback

Zusätzliche Ressourcen