Die REST-API bietet eine effiziente Möglichkeit, um auf Daten und Funktionen innerhalb der Salesforce-Plattform zuzugreifen. Durch HTTP-Anfragen ist eine Interaktion mit Salesforce möglich. Die REST-API ist synchron und stellt eine einfache Methode zur Anbindung an Salesforce dar, als die SOAP-API. Da die REST-API auf einer jüngeren Technologie basiert, ist sie eine bevorzugte Methode zur Integration von Salesforce.
Grundlagen
Die REST API ist eine webbasierte Schnittstelle, die es ermöglicht, auf Daten und -Funktionen von Salesforce über das HTTP-Protokoll zuzugreifen. Sie bietet eine flexible und leistungsstarke Möglichkeit, Salesforce-Daten in Anwendungen von Drittanbietern, mobilen Anwendungen und benutzerdefinierten Anwendungen zu integrieren.
Die REST-API unterstützt verschiedene Formate wie JSON, XML und CSV und ermöglicht es, Salesforce-Daten abzurufen, zu erstellen, zu aktualisieren und zu löschen. Sie können Daten filtern und sortieren, Chatter-Nachrichten erstellen und abrufen, Dateianhänge abrufen und hochladen, Benutzer- und Gruppendaten abrufen, Prozesse automatisieren und Salesforce-Abfragen per SOQL erstellen.
Um die REST API von Salesforce anzubinden, können verschiedene C#-Bibliotheken verwenden werden. Beispielsweise kann der Standard .Net HTTPClient verwendet werden oder Open-Source-Libraries wie beispielsweise NetCoreForce.Client 3.1.0.
Art der Anbindung
In diesem Artikel wird die REST API von Salesforce mithilfe des Nugets NetCoreForce.Client 3.1.0 angebunden.
NetCoreForce.Client 3.1.0 ist eine C#-Bibliothek, die speziell für die Integration der REST-API entwickelt wurde. Die Bibliothek bietet eine Vielzahl von Funktionen und Methoden, um Salesforce-Daten abzurufen, zu erstellen, zu aktualisieren und zu löschen.
Die Bibliothek unterstützt die OAuth2. Im Code-Behind wird die HttpClient-Klasse von .NET verwendet, um HTTP-Aufrufe an die REST-API zu senden.
Authentifizierungsmöglichkeiten
Die Bibliothek bietet die OAuth-Authentifizierung mittels UserName-Password-Flow an.
Vorbereitende Maßnahmen / Voraussetzung (optional)
Authentifizierung
Die Authentifizierung erfolgt über OAuth2 mittels Connected App (weitere Informationen finden Sie auf unserem Beitrag Salesforce Integration)
Limitierung
Siehe hierzu unter Salesforce Developers (
aktuelle Version der API auswählen).
Code-Beispiel
Initialisierung:
using NetCoreForce.Client;
var client = new ForceClient("https://instance_name.salesforce.com",
"access_token",
"refresh_token",
"client_id",
"client_secret");
Abfragen von Daten:
// Abrufen von Kontakten mittels SOQL
var contacts = await client.QueryAsync<Contact>("SELECT Id, Name, Email FROM Contact");
// Abrufen eines einzelnen Kontakts
var contact = await client.QueryByIdAsync<Contact>("Contact", "contact_id");
Erstellen von Daten in Salesforce:
var newContact = new Contact()
{
FirstName = "John",
LastName = "Doe",
Email = "john.doe@example.com"
};
var response = await client.CreateAsync("Contact", newContact);
Hinzufügen eines Clients für Dependecy Injection (JWT-Token-Flow):
[...]
.ConfigureServices((hostBuilderContext, services) =>
{
[...]
//JWT Bearer Token Flow
_ = services.AddScoped(t => new ForceClient(new AuthInfoJwtBearerTokenFlow
{
ApiVersion = to be filled,
Certificate = to be filled,
ClientId = to be filled,
PrivateKey = to be filled,
Username = to be filled,
TokenRequestEndpoint = to be filled,
}));
[...]
});
[...]
Sie haben Fragen oder möchten mehr über unsere Produkte und Dienstleistungen erfahren?
Kontaktieren Sie uns jetzt über unser Kontaktformular!
