SupportAnmelden
Sprechen Sie mit uns

Konnektor

REST-Webservice-Konnektor

Ihr System steht nicht auf der Liste? Wenn es eine REST-API hat, kann Rapidi es in der Regel anbinden.

Ja, wenn es eine REST-API hat. Die REST-Webservice-Verbindung von Rapidi überträgt Daten zu und von REST-basierten Diensten und ermittelt deren Objekte und Felder aus einer Beschreibung als JSON-Schema oder Swagger 2.0. Da es keinen einheitlichen REST-Standard gibt, erfordern manche Dienste zusätzliche Einrichtung. Sagen Sie uns, welchen Dienst Sie nutzen möchten, und wir planen die Anbindung gemeinsam mit Ihnen.

Was angebunden wird
Jeder REST-basierte Webservice, in der Cloud oder in Ihrem eigenen Netzwerk.
In welche Richtung die Daten fließen
In beide Richtungen. Rapidi überträgt Daten zum Dienst und vom Dienst.
Was Sie benötigen
Die Adresse des Dienstes, eine Möglichkeit zur Anmeldung und idealerweise eine Beschreibung der API als JSON-Schema oder Swagger 2.0.

Was leistet dieser Konnektor konkret?

Kurz gesagt: Sie verweisen Rapidi auf den REST-Dienst, Rapidi liest die Beschreibung der API, und jedes Objekt und jedes Feld aus dieser Beschreibung können Sie anschließend zuordnen.

Der REST-Webservice-Konnektor im Überblick.
Was er liestDie Objekte und Felder, die in den JSON-Schema- oder Swagger-2.0-Metadaten des Dienstes beschrieben sind. Sie geben die Metadaten-URL ein und klicken auf Read Design.
RichtungIn beide Richtungen. Die Verbindung überträgt Daten zum REST-Dienst und vom REST-Dienst.
Wie er sich anmeldetOhne Authentifizierung, Basic (Benutzer-ID und Passwort), ein Token, eine Token-Anfrage, die ein JWT-Bearer-Token zurückgibt, OAuth2 mit Azure Active Directory oder NTLM in einem lokalen Netzwerk.
Große DatenmengenSeitenweises Lesen. Mit einem Quellfilter wie limit=20 ergänzt Rapidi jede Anfrage um einen Offset, bis keine Daten mehr zurückkommen.
Nur geänderte DatensätzeSource Control fügt jeder Anfrage den zuletzt gelesenen Wert hinzu, sodass der Dienst nur neuere Datensätze zurückgibt.
Wie oft er läuftNach einem Zeitplan, den Sie festlegen. Das kürzeste Intervall hängt von Ihrem Tarif ab, von einer Stunde bei Entry bis zu einer Minute bei Unlimited.
Wo er laufen kannDirekt gegen einen REST-Endpunkt im Internet oder über den RapidiConnector bei lokalen Installationen und bei Hosting, das Sie selbst kontrollieren.
SicherheitSSL (HTTPS) ist eine Einstellung der Verbindung, und Rapidi empfiehlt, sie immer zu verwenden.

Welche Systeme sind bereits auf diese Weise angebunden?

Mehrere Systeme in der Rapidi-Dokumentation laufen über genau diese Verbindung, jedes mit einem JSON-Schema, das festlegt, was zugeordnet werden kann.

In der Dokumentation beschriebene Systeme auf der REST-Webservice-Verbindung.
SystemWofür es genutzt wirdWie es sich anmeldetWer das Schema pflegt
WorkdayMeist die Quelle für HR-Daten wie Mitarbeiterstammdaten, Positionen und die Organisationshierarchie, die in ein ERP- oder CRM-System fließenDie REST-Endpunkte von WorkdayDer Kunde, sodass ein neues Workday-Feld keine Änderung durch Rapidi erfordert
DayforceMeist das Ziel für Arbeitszeit- und Lohndaten der Mitarbeiter, die aus einem anderen operativen System kommenToken-Anmeldung an der Dayforce-APIDas Schema definiert jedes Dayforce-Objekt, das zugeordnet werden kann
StoryblokAbrufen von Inhalten aus dem Headless CMS StoryblokEin Storyblok-API-TokenRapidi erstellt es anhand Ihrer API-Dokumentation und des Umfangs der Integration

REST-Dienste sind auf sehr unterschiedliche Weise aufgebaut, weil es für REST und JSON keinen einheitlichen Standard gibt. Sagen Sie uns, welchen Dienst Sie wofür nutzen möchten, und wir sagen Ihnen, ob wir ihn bereits bei anderen Kunden eingesetzt haben.

Häufig gestellte Fragen

Kann Rapidi ein System anbinden, das nicht auf der Konnektorenliste steht?

In der Regel ja, wenn das System einen REST-Webservice anbietet. Rapidi erreicht es über die generische REST-Webservice-Verbindung. Möglicherweise ist zusätzliche Einrichtung nötig. Sagen Sie uns daher, welchen Dienst Sie wofür nutzen möchten, und wir sagen Ihnen, ob wir ihn bereits bei anderen Kunden eingesetzt haben.

Wie erfährt Rapidi, was eine REST-API enthält?

Aus ihrer Beschreibung. Wenn der Dienst ein JSON-Schema oder Swagger-2.0-Metadaten veröffentlicht, geben Sie diese URL im Feld Metadata URL ein und klicken auf Read Design. Wenn nicht, benötigen wir die Angaben zu den Endpunkten von Ihnen, vorzugsweise als JSON-Schema.

Welche Anmeldeverfahren unterstützt die REST-Verbindung?

Keine Authentifizierung, Basic mit Benutzer-ID und Passwort, ein Token, eine Token-Anfrage, die ein JWT-Bearer-Token zurückgibt, OAuth2 mit Azure Active Directory und NTLM in einem lokalen Netzwerk. Für OAuth2 mit einem anderen Verzeichnisdienst als Azure Active Directory wenden Sie sich an uns.

Kann sie große Datenmengen seitenweise lesen?

Ja. Fügen Sie dem Transfer einen Quellfilter wie limit=20 hinzu, und Rapidi ergänzt jede Anfrage um einen Offset, bis keine Daten mehr zurückkommen.

Kann sie nur die geänderten Datensätze übertragen?

Ja. Das Feld, das im Transfer unter Source Control angegeben ist, wird jeder Anfrage mit dem zuletzt von Rapidi gelesenen Wert hinzugefügt, sodass der Dienst nur neuere Datensätze zurückgibt.

Muss auf unserer Seite etwas installiert werden?

Nicht für einen REST-Dienst, den Rapidi über das Internet erreichen kann. Eine neue REST-Verbindung wird mit einem zugeordneten RapidiConnector angelegt; löschen Sie ihn, damit Rapidi sich direkt verbindet. Der RapidiConnector wird nur für lokale Installationen, für Hosting, das Sie selbst kontrollieren, oder für die NTLM-Anmeldung benötigt.

Was kostet der REST-Webservice-Konnektor?

Für sich genommen nichts. Rapidi wird pro Abonnement-Tarif statt pro Konnektor abgerechnet, sodass ein zusätzlicher REST-Dienst nichts an der Lizenz ändert.

Fehlt Ihr System in der Liste?

Sagen Sie uns, welchen Dienst Sie betreiben und was übertragen werden muss, und wir sagen Ihnen offen, ob die REST-Verbindung das abdeckt.

Finden Sie heraus, ob es zu Ihrer Umgebung passt

Sagen Sie uns, welche Systeme Sie nutzen, und wir sagen Ihnen offen, ob Rapidi das richtige Werkzeug ist.