API v1.0

API dla deweloperów

Zintegruj SignaGenius z istniejącymi przepływami pracy. Nasze REST API pozwala programowo zarządzać członkami zespołu, wyzwalać synchronizacje i pobierać analitykę w czasie rzeczywistym.

Uwierzytelnianie

Wszystkie żądania API muszą być uwierzytelnione za pomocą tokena Bearer. Możesz wygenerować klucze API w Panel Admina > Ustawienia > Deweloperzy.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://panel.signagenius.com/api/v1/users

Endpointy

GET/users

Lista wszystkich członków zespołu i status ich podpisu.

zakres: users:read?limit=1...200?offset=0...1000000
POST/users

Utwórz zarządzanego użytkownika przestrzeni roboczej.

zakres: users:write
GET/users/{id}

Pobierz jednego zarządzanego użytkownika w obrębie dzierżawy.

zakres: users:read
PATCH/users/{id}

Zaktualizuj obsługiwane pola profilu lub status konta.

zakres: users:write
DELETE/users/{id}

Miękko wyłącz użytkownika, zachowując jego historię audytu.

zakres: users:write
POST/users/batch

Twórz, aktualizuj lub wyłączaj do 100 użytkowników z wynikiem dla każdego wiersza i idempotentnym powtórzeniem.

zakres: users:writeheader: Idempotency-Key
GET/signatures

Wypisz 200 najnowszych wygenerowanych artefaktów podpisu.

zakres: signatures:read?user_id
GET/change-requests

Wypisz nadzorowane prośby o zmianę profilu.

zakres: requests:read?status=pending|approved|rejected
GET/analytics

Pobierz analitykę kliknięć w linki dla określonego zakresu czasu.

zakres: analytics:read?days=1...365
GET/audiences

Wypisz wielokrotnego użytku odbiorców kampanii wraz z rozwiązanymi członkami.

zakres: audiences:read
POST/audiences

Utwórz lub idempotentnie zastąp odbiorców zarządzanych przez API.

zakres: audiences:write
GET/audiences/{id}

Pobierz jednych odbiorców wraz z rozwiązanymi członkami.

zakres: audiences:read
PUT/audiences/{id}

Zastąp odbiorców i całą ich listę członków.

zakres: audiences:write
DELETE/audiences/{id}

Usuń odbiorców wielokrotnego użytku.

zakres: audiences:write
GET/webhooks

Wypisz podpisane subskrypcje webhooków bez ich sekretów.

zakres: webhooks:write
POST/webhooks

Utwórz subskrypcję i jednorazowo otrzymaj jej sekret podpisujący.

zakres: webhooks:write
PATCH/webhooks/{id}

Zaktualizuj, włącz lub wstrzymaj subskrypcję webhooka.

zakres: webhooks:write
DELETE/webhooks/{id}

Usuń subskrypcję webhooka.

zakres: webhooks:write
GET/export

Pobierz wersjonowany eksport konfiguracji przestrzeni roboczej - bez poświadczeń, sekretów, historii zdarzeń i artefaktów możliwych do odtworzenia.

zakres: exports:read

Potrzebujesz pomocy?

Nasz zespół inżynierów jest tutaj, aby pomóc Ci w integracji.

Porozmawiaj z Wsparciem