Socios

Registrar una aplicacion OAuth

1. Vaya al panel de Socios y haga clic en "Nueva aplicacion OAuth".
2. Ingrese el nombre de su aplicacion, la descripcion y la URL del sitio web.
3. Agregue una o mas URIs de redireccion (estas deben ser HTTPS en produccion).
4. Guarde su client ID y client secret de forma segura.

Flujo de autorizacion

Apertur utiliza el flujo estandar de OAuth 2.0 Authorization Code. Redirija a sus usuarios a:

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

Intercambio de tokens

Despues de que el usuario autorice su aplicacion, intercambie el codigo de autorizacion por un token de acceso:

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"
  }'

Uso del token de acceso

Incluya el token de acceso en el encabezado Authorization de todas las solicitudes a la API realizadas en nombre del usuario. Los tokens expiran despues de 1 hora: use el refresh token para obtener uno nuevo.

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>