API

Crea e gestisci i link AffKeeper in modo programmatico tramite una semplice API JSON.

AffKeeper espone un’API JSON con cui puoi creare e gestire i link dal tuo codice o dai tuoi strumenti. È la stessa API usata dal plugin WordPress.

Riferimento interattivo

Il riferimento completo e sempre aggiornato degli endpoint (schemi, parametri, try-it-out) è generato dal servizio live:

Docs interattive: https://affkeeper.com/api/reference
Schema OpenAPI: https://affkeeper.com/openapi.json

Autenticazione

L’API si autentica con una chiave API bearer.

Nel pannello, vai su Impostazioni → Chiavi API e crea una chiave. Copiala — viene mostrata una sola volta.
Inviala in ogni richiesta nell’header Authorization:
```
Authorization: Bearer YOUR_API_KEY
```

Tieni la chiave segreta. Puoi revocare o eliminare una chiave dalla stessa schermata in qualsiasi momento; una chiave revocata smette di funzionare immediatamente.

URL di base

https://affkeeper.com/api

Esempio

Creare un link (vedi il riferimento interattivo per lo schema esatto di richiesta/risposta):

curl -X POST https://affkeeper.com/api/v1/links \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination_url": "https://example.com/product", "domain_id": null}'

Limiti di frequenza ed errori

Le richieste hanno un limite di frequenza per IP; i client ben educati non lo raggiungeranno.
Gli errori restituiscono un body JSON con un messaggio error e uno stato HTTP appropriato (400 input errato, 401 chiave errata/mancante, 429 troppe richieste).