Technische documentatie voor integrators

From Sidefish Wiki
Revision as of 11:00, 27 October 2022 by Thomas.sonck (talk | contribs)
Jump to navigation Jump to search

Sidefish v5 API Documentation

General

The Sidefish API is a RESTFUL JSON HTTP API that serves all server functions for creating, reading, updating and deleting Sidefish Platform data.

Successful calls always return a HTTP status 200.

Errors are returned with corresponding HTTP statuses, like 400, 403, 404 , etc. The response body contains an error description.

Endpoint

The Sidefish API is reachable at:

https://sidefish.app/api/v1/ (PRODUCTION)

https://staging.sidefish.app/api/v1/users (STAGING)

Authentication

A. Bearer token

1. Request a JWT token via the login call.

Endpoint Method Request Body Response Body
/login POST
{
    email: string,
    password: string
}
{
    token: string
}
/logout POST
{}


2. Use the

Portfolios

Customers

Vragenlijsten

Sessie verzoeken