Effectuer un premier appel.

Ce guide décrit l’obtention d’un jeton, la vérification de la connexion et une première lecture du catalogue.

Les identifiants et jetons doivent rester sur votre serveur. Ne les placez jamais dans le JavaScript envoyé au navigateur.

Les étapes

Configurer les accès
Utilisez l’URL de l’environnement, le compte API et les permissions fournis pour votre intégration.
Obtenez un jeton JWT
Authentifiez le compte avec POST /auth. Le jeton retourné accompagne ensuite chaque route protégée.
Vérifiez la connexion
Appelez GET /v1/ping avant de commencer votre synchronisation métier.
Chargez les données
Pour un site marchand, commencez par les boutiques et référentiels, puis utilisez le catalogue agrégé.

Exemple complet

1. Obtenir le jeton

Authentificationbash

curl -X POST https://api.hbjo-online.com/auth \
  -H "Content-Type: application/json" \
  -d '{
    "email": "integration@votre-site.fr",
    "password": "••••••••••••"
  }'

Réponse 200json

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

2. Interroger le catalogue

Catalogue paginébash

curl "https://api.hbjo-online.com/v1/catalog/products?page=1&limit=50" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

À faire ensuite

Consultez ensuite un guide métier ou la liste des opérations et des scopes disponibles.

Concept suivantComprendre l’authentification →Premier parcoursSynchroniser le catalogue →