How to use an SIP API

The SIP provides several APIs that can be used in applications to access additional functionality (such as sending an email message) or accessing centrally managed data (such as information about users). All VSETH APIs are managed using SerVIS and more information about how to manage an API can be found in the Servis documentation. These How-to gives an introduction how to easily integrate an API into your application.

(1) Setup

All VSETH APIs are managed in the central API registry of VSETH called SerVIS. The APIs itself are GRPC and use Protobuf for the description. See APIs (GRPC / Protobuf) for more information.

To access an API definition you need the Servis CLI, which you can download from https://tools.vseth.ethz.ch. After downloading the CLI make sure it is executable and can be found in your $PATH.

Then you can execute:


(2)