Vos premières requêtes API

Commencez par des requêtes en lecture seule pour vérifier la connectivité, les identifiants et le contexte d’équipe. Vous avez besoin de la CLI et, pour la procédure bearer documentée, d’un accès administrateur à l’équipe sélectionnée.

Vérifier le point de santé public

curl --fail-with-body https://api.adios.dev/v1/health

Cette requête ne nécessite pas d’authentification. Une réponse de santé réussie vérifie le chemin de l’API publique ; elle ne vérifie ni votre compte ni votre déploiement d’exécution.

Définissez vos identifiants privés

Utiliser Authentification API pour obtenir un jeton de diagnostic, puis saisissez-le sans enregistrer sa valeur dans l’historique du shell. Pour bash :

export ADIOS_API_URL=https://api.adios.dev
export ADIOS_TEAM_ID=YOUR_TEAM_ID
read -r -s -p 'Access token: ' ADIOS_ACCESS_TOKEN
export ADIOS_ACCESS_TOKEN

Remplacez YOUR_TEAM_ID sur l’équipe sélectionnée dans la CLI. Le jeton doit concerner cette même équipe.

Vérifier votre identité et vos ressources

curl --fail-with-body "$ADIOS_API_URL/v1/auth/me" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

curl --fail-with-body "$ADIOS_API_URL/v1/workload?page=1&per_page=20" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

curl --fail-with-body "$ADIOS_API_URL/v1/team/deployment-context" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Vérifiez votre identité, les ressources de l’équipe et le contexte de déploiement disponible. Utilisez les ID de ressources renvoyés et les régions disponibles dans les requêtes suivantes. N’inventez pas d’ID à partir des exemples synthétiques.

Supprimez la variable temporaire du jeton après la session :

unset ADIOS_ACCESS_TOKEN

Privilégiez un stockage de secrets côté client pour un usage régulier. Pour Postman, suivez les instructions de configuration de la collection. Analysez un statut d’échec à l’aide des erreurs et pagination.