1. Strona główna
  2. Extra
  3. Samba API
  4. Eksportowanie statusu subskrypcji klienta przez API

Eksportowanie statusu subskrypcji klienta przez API

Spis treści

This post is also available in: Czeski Angielski

Za pomocą interfejsu API można zsynchronizować status subskrypcji klienta w Sambie z Twoim systemem. Możesz pobrać całą listę lub tylko zmiany (tylko klientów, którzy zmienili poziom subskrypcji newslettera w przedziale <od, do teraz>). Możesz także wybrać, czy chcesz wyeksportować klientów, którzy posiadają subskrypcję lub jej nie posiadają. Wszystkie dane są dostarczane w oparciu o synchronizacje danych w Sambie. Uwzględniani są wszyscy klienci w Sambie – z kanału klientów, zaimportowani klienci i subskrybenci zebrani z popupów.

Punkt końcowy URL'a

W zależności od swojego pakietu wybierz odpowiedni adres URL punktu końcowego.

  • Jeśli logujesz się przez app.samba.ai –> wybierz adres URL api.samba.ai
  • Jeśli logujesz się przez enterprise.samba.ai –> wybierz adres URL api.yottly.com

Identyfikator konta można znaleźć w Ustawieniach jako część unikalnego skryptu śledzenia.

GET

https://api.samba.ai/shop/sambaId/subscriptions?from=YYYY-MM-DD&state=subscription_state
header: X-Api-Key: your-api-key
  • sambaId – Trackpoint ID sklepu z samby
  • your-api-key – klucz Samba API dla twojego sklepu
  • from – [opcjonalnie] data w formacie RRRR-MM-DD  (czas jest ustawiony na 00:00). Jeśli ten parametr zostanie pominięty, wyeksportowana zostanie cała historia.
  • state – [opcjonalnie] wybierz „subscribed” lub „unsubscribed”. Jeśli pominiesz ten parametr, wyeksportowane zostaną wszystkie stany logowania.

ODPOWIEDŹ

Format JSON – jeden obiekt json na jedną linię (application/json-seq):

{"customerId":"XYZ123", //ID of Customer
  "email":"xyz123@samba.ai", // Customer's email address
  "newsletterFrequency":"every day", //Customer's current subscription preferences: "every day"/"special occasions" = subscribed, "never" = unsubscribed
  "since":1526481188957 //time (in milliseconds) since subscribing
}

PRZYKŁAD

curl -H 'X-Api-Key: key' 'https://api.samba.ai/shop/4541245641234564/subscriptions?from=2018-04-19'
{"customerId":"XYZ123","email":"xyz123@samba.ai","newsletterFrequency":"every day","since":1526481188957}
{"customerId":"ABC123","email":"abc123@samba.ai","newsletterFrequency":"never","since":1526481188957}
{"customerId":"XAZ1R3","email":"xaz1r3@samba.ai","newsletterFrequency":"every day","since":1526481188957}
curl -H 'X-Api-Key: key' 'https://api.samba.ai/shop/4541245641234564/subscriptions?from=2018-04-19&state=subscribed'
{"customerId":"XYZ123","email":"xyz123@samba.ai","newsletterFrequency":"every day","since":1526481188957}
{"customerId":"XAZ1R3","email":"xaz1r3@samba.ai","newsletterFrequency":"every day","since":1526481188957}

This post is also available in: Czeski Angielski

Zaktualizowano na 6 maja, 2025

Czy ten artykuł był pomocny?

Artykuły powiązane