Zugriff auf das API

asis URL: https://api.dealsandprojects.com

Alle Aufrufe müssen über SSL (HTTPS) erfolgen.

Authentifizierung: Basic HTTP Authentifizierung mit E-Mail-Adresse und ApiKey des Benutzers.
Der julitec Benutzer muss Admin-Rechte haben, um auf die API zugreifen zu können.

Ermittlung des Api Keys:
Einloggen mit E-Mail-Adresse und Passwort unter https://api.dealsandprojects.com. Anschließend https://api.dealsandprojects.com/Login/GetApiKey aufrufen. Der Api Key wird angezeigt.

Das API folgt dem REST Standard. D.h. über HTTP Aufrufe können Datensätze im JSON Format gelesen und geschrieben werden.

Zum Testen kann man sich im Browser unter https://api.dealsandprojects.com einloggen und anschließend die Datenabrufe direkt im Browser testen, z.B. <apiurl>/api/order.
Da der Browser nicht den Content-Type: application/json übergibt, ist das Ergebnis eine XML-Datei. Die Deals&Projects API kann grundsätzlich mit XML und JSON umgehen. Für XML wird der Content-Type: text/xmlverwendet.

Bei POST Aufrufen können Felder, die nicht gefüllt werden sollen, weggelassen werden.

Datumsfelder müssen das Format "yyyy-MM-ddTHH:mm:ss" haben.

Paging

Bei Listenabrufen werden standardmäßig immer 50 Einträge zurückgeliefert. Über die Parameter "Skip" und "Take" kann gesteuert werden, welcher Ausschnitt der Daten abgefragt wird. Werte größer 100 werden ignoriert für den Parameter Take.

Beispiel:

<apiurl>/api/order?Skip=100&Take=100

In diesem Beispiel werden die Aufträge 101 bis 200 zurückgeliefert.

Eigene Felder

Sind für eine Entität eigene Felder definiert, so werden diese automatisch beim Abruf der Daten über GET mitgeliefert. Außerdem können die eigenen Felder beim Schreiben der Entität gesetzt werden. Ein Beispiel finden Sie hier: Kontakt anlegen

Eigene Felder werden durch ein Dictionary mit folgenden Feldern angegeben:

Beispiel JSON Body:

"CustomField":{
      "TextFeld":"Mit Inhalt",
      "ZweitesFeld":"Im zweiten Feld"
   },

Überblick über die Endpunkte / Aufrufe