Zum Hauptinhalt springen

EASY Archive - REST

Die offizielle Dokumentation der REST-Schnittstelle des EASY Archive Content Webservice kann hier eingesehen werden.

Zusätzliche Hinweise

  • Neue Dokumente müssen beim POST unbedingt die Eigenschaft "status": "archived" bekommen, sonst kann es im schlimmsten Fall zu Datenverlust kommen!
  • Die Suche leitet standardmäßig auf eine Ergebnisseite weiter. Der Client muss dafür Redirects folgen können! Alternativ muss der Header ausgewertet werden und dann über den GET auf die Search Result Page die entsprechende Suchergebnisseite aufgerufen werden
  • Das Lizenzhandling ist kompliziert. Am sichersten ist es, nach jedem API Call einen Logout zu triggern. Alternativ muss sichergestellt sein, dass die Clients die gleiche HTTP(S)-Verbindung (kein Pooling, keine neue Session - exakt die gleiche!) benutzen. Bei jeder zusätzlichen Verbindung mit dem gleichen Nutzer kommt es sonst zu Lizenzfehlern
  • Bei parallelen Requests muss über eine Queue sichergestellt werden, dass die Requests sequentiell abgearbeitet werden (oder auf verschiedene Userkonten verteilt werden), um Lizenzfehler (Doppelbelegung) zu vermeiden
  • Wenn ein Lizenzfehler auftritt, muss der Timeout für diesen User abgewartet werden (Standard: 1 Stunde!)