Einleitung

Die Erfahrungen mit der oDATA API (V1) in der Praxis waren unterschiedlich. Insbesondere konnten einige Stabilitätsprobleme festgestellt werden, weshalb wir ab der Version Moléson (6.x) zusätzlich eine REST-API bereitstellen. Die bestehende API (V1) bleibt bis auf weiteres bestehen. Es werden jedoch keine Erweiterungen mehr daran vorgenommen und neue Funktionen werden nur noch in der Version 2 gepflegt. Im Gegensatz zur Version 1 stehen in der neuen Version nun sämtliche vorhandenen Endpoints zur Verfügung. Für eine leichtere Implementation steht neu zudem eine SDK und eine Swagger Dokumentation zur Verfügung.

In der Nachfolgenden Dokumenten wird die API sowie die SDK näher beschrieben.

How-to Artikel

Verwandte Artikel

...

Introduction

All the data stored in the CoreOne Meta Directory can directly be accessed and modified by using our API V2. In earlier version (< 6.0), only a handful of operations where possible by using the V1 of the API. Those legacy endpoints will stay untouched, but new features will only be available in the newer version of the API. On the subsequent pages you will find all the details.

Data Centric vs. Business Centric Endpoints

As described, the API-V2 exposes all data stored stored in the CoreOne Meta Directory. When performing mutations on that data, no business logic is executed. So even though you can add a new role to a core identity, no additional task such as the assignment task will be triggered. You will have to wait for the regular job intervall to start until your changes will be processed. In some cases this is fine and might be even desired.

However, if you would like to change data and also trigger the appropriate business logic, you should use the business centric endpoints described in the appropriate documentation.