Partenaires

Enregistrer une application OAuth

1. Allez dans le tableau de bord Partenaire et cliquez sur « Nouvelle application OAuth ».
2. Entrez le nom de votre application, sa description et l'URL de votre site Web.
3. Ajoutez une ou plusieurs URI de redirection (celles-ci doivent être en HTTPS en production).
4. Conservez votre identifiant client et votre secret client de manière sécurisée.

Flux d'autorisation

Apertur utilise le flux standard OAuth 2.0 Authorization Code. Redirigez vos utilisateurs vers :

https://apertur.ca/oauth/authorize?
  client_id=your_client_id&
  redirect_uri=https://your-app.com/callback&
  response_type=code&
  scope=sessions:write destinations:read&
  state=random_csrf_token

Échange de jeton

Après que l'utilisateur a autorisé votre application, échangez le code d'autorisation contre un jeton d'accès :

curl -X POST https://api.apertur.ca/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "authorization_code",
    "client_id": "your_client_id",
    "client_secret": "your_client_secret",
    "code": "auth_code_from_callback",
    "redirect_uri": "https://your-app.com/callback"
  }'

Utiliser le jeton d'accès

Incluez le jeton d'accès dans l'en-tête Authorization de toutes les requêtes API effectuées au nom de l'utilisateur. Les jetons expirent après 1 heure — utilisez le jeton de rafraîchissement pour en obtenir un nouveau.

Authorization: Bearer oat_xxxxxxxxxxxx

Public Key

Each OAuth app gets a unique public key (format: aptr_pk_...). This key is safe to expose in frontend code and is used to initialize the SDK. You can find it in your OAuth app settings.

Allowed Domains

Restrict which domains can use your public key by configuring allowed domains. Wildcards are supported: *.example.com matches any subdomain including nested ones (e.g. app.example.com, staging.app.example.com). Leave empty during development to allow all origins.

Installation

<script src="https://cdn.apertur.ca/sdk/aptr-connect.js"></script>

Usage

<script>
  AptrConnect.init({ publicKey: "aptr_pk_your_key_here" });

  document.getElementById("connect-btn").addEventListener("click", () => {
    AptrConnect.authorize({
      scopes: ["upload:create", "project:read"],
      onSuccess: (result) => {
        // Send result.code to your backend to exchange for a token
        console.log("Authorization code:", result.code);
      },
      onError: (err) => console.error(err),
    });
  });
</script>