Premier appel

Trois étapes : lire un exemple de payload, obtenir un token, appeler l’export.

  1. Exemple sans clé

    Endpoint public :

    curl 'https://api.octave.immo/v1/sample/export'

  2. Token OAuth

    Compte sandbox (lecture seule) :

    • client_id = oct_demo_sandbox
    • client_secret = demo_secret_change_me

    application (slug, token ou id) est requis si l’accès couvre plusieurs applications. 

    curl -X POST 'https://api.octave.immo/oauth/token' \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "oct_demo_sandbox",
    "client_secret": "demo_secret_change_me",
    "application": "slug-ou-token"
  }'

  3. Export

    curl 'https://api.octave.immo/v1/programs/export?page=1&per_page=5' \
  -H 'Authorization: Bearer ACCESS_TOKEN'

    La réponse contient total / meta.total (nombre total de programmes) et meta.last_page. Incrémentez page tant que current_page < last_page.

Base URL : sous-domaine API, sans préfixe /api (ex. https://api.octave.immo). Les URLs /api/… redirigent vers l’équivalent sans préfixe.