API

Twórz linki AffKeeper i zarządzaj nimi programistycznie przez proste API JSON.

AffKeeper udostępnia API JSON, dzięki któremu możesz tworzyć linki i zarządzać nimi z własnego kodu lub narzędzi. To to samo API, którego używa wtyczka WordPress.

Interaktywna dokumentacja

Pełna, zawsze aktualna dokumentacja endpointów (schematy, parametry, tryb try-it-out) jest generowana z działającej usługi:

Interaktywna dokumentacja: https://affkeeper.com/api/reference
Schemat OpenAPI: https://affkeeper.com/openapi.json

Uwierzytelnianie

API jest uwierzytelniane kluczem API typu bearer.

W panelu przejdź do Ustawienia → Klucze API i utwórz klucz. Skopiuj go — jest pokazywany raz.
Wysyłaj go z każdym żądaniem w nagłówku Authorization:
```
Authorization: Bearer YOUR_API_KEY
```

Trzymaj klucz w tajemnicy. Klucz możesz w każdej chwili unieważnić lub usunąć z tego samego ekranu; unieważniony klucz przestaje działać natychmiast.

Bazowy URL

https://affkeeper.com/api

Przykład

Tworzenie linku (dokładny schemat żądania/odpowiedzi znajdziesz w interaktywnej dokumentacji):

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

Limity zapytań i błędy

Żądania są limitowane per IP; dobrze zachowujące się klienty nie trafią na limit.
Błędy zwracają JSON z komunikatem error i odpowiednim statusem HTTP (400 błędne dane, 401 zły/brakujący klucz, 429 zbyt wiele żądań).