Endpoints REST

L’API propose également certains endpoints REST en addition de GraphQL.

GET /_health

Cet endpoint renvoie toujours 200 OK. Une réponse différente indique que le serveur web n’est pas accessible.

Tip

L’endpoint /_readiness est préférable pour s’assurer que l’API est fonctionnelle

GET /_readiness

Cet endpoint vérifie que l’application est prête en envoyant une requête ping à la base de donnée afin de s’assurer que la connexion est active.

GET /photo/v1/{id}

Le champ photo du type User ne renvoie pas le contenu de la photo utilisateur directement, mais une URL pointant sur cet endpoint.

Ces URLs sont signées et valides pour une durée de 1h. Elles peuvent donc être inclues dans une page web, tant que l’accès est authentifié.

Important

Il n’est pas possible d’appeler l’endpoint directement pour obtenir la photo d’un utilisateur. Il faut passer par le type User GraphQL pour obtenir une URL paramétrée.

Exemple d’URL :

https://api.iiens.net/photo/v1/mcfly1985?expires=1777071680&signature=ebd68c315e9810714c6ff648c55284ef999b15a96800dd5f1cba573def300b0a

GET /picture/v1/{id}

Cet endpoint est équivalent à /photo/v1/{id}, mais pour les images de profil utilisateur.