#Utiliser Dwitch API đŸ„™

  • Pour l’application Dwitch, j’ai mis en place un back-end sous Strapi.
  • C’est ce serveur que vous allez appeler pour rĂ©cupĂ©rer les donnĂ©es et les afficher dans votre application.

La route de base de l’API est https://dwitch.pickle-forge.app/api.

#Routes d’API disponibles

Le back-end est sous Strapi et il met à disposition les routes comme documenté ici : Endpoints Strapi REST

Et dans l’API Dwitch, vous avez les types suivants :

  • ingredient : Les ingrĂ©dients disponibles
  • store : Les magasins disponibles
  • order : Les commandes passĂ©es
  • user : Les utilisateurs
  • post : Les news

Donc pour rĂ©cupĂ©rer les ingrĂ©dients, vous aurez une route /ingredients qui vous renverra un tableau d’ingrĂ©dients.

La route de base de l’API est https://dwitch.pickle-forge.app/api.

🆙 Pour tester les routes avant de coder, utilisez un outil comme Postman ou Insomnia.

Si vous arrivez à récupérer les données avec Postman, vous pourrez les récupérer dans votre application plus facilement.

A vous donc d’utiliser l’API de Strapi pour rĂ©cupĂ©rer les donnĂ©es nĂ©cessaires Ă  votre application dans les vues Ă  dĂ©velopper.

A penser

Utilisez bien populate avec Strapi pour récupérer les sous-object de vos données, par défaut Strapi ne renvoie que les ID des relations.

#Authentification

Les donnĂ©es de l’API ne sont pas publiques, il faut donc s’authentifier pour les rĂ©cupĂ©rer.

2 mĂ©thodes d’authentification sont disponibles :

#Bearer Token Simple

Utile au début

Pour cela, vous devez ajouter un header Authorization avec la valeur Bearer <token> Ă  chaque requĂȘte HTTP que vous faites Ă  l’API.

  • Utilisez soit header au niveau de l’appel Ă  Retrofit (@Header), soit au niveau de l’Interceptor de OkHttp avec un client custom que vous passerez Ă  Retrofit.

#JWT

Pour une utilisation plus sĂ©curisĂ©e et limitĂ© Ă  l’utilisateur connectĂ©

Dans ce cas, vous devez vous authentifier avec un utilisateur particulier

  1. Via une requĂȘte POST sur /auth/local
  2. Le serveur vous renverra un token JWT que vous devrez ajouter dans le header Authorization de chaque requĂȘte par la suite.
  3. Vous pourrez donc accĂ©der aux donnĂ©es de l’utilisateur connectĂ©.

Pour le “Bearer Token Simple”

Demandez moi le token pour tester l’API.

Attention

  • Ne stockez jamais de mot de passe en dans votre code, ou tout autre clĂ© d’API. Utilisez toujours des fichiers secrets ou des variables d’environnement.
  • Je vous ai mis une ressource pour cela ici

#📚 Ressources