Jak korzystać z publicznego API systeme.io (Interfejs Programowania Aplikacji)

W tym artykule dowiesz się, jak skonfigurować i używać publicznego API systeme.io, w tym jak generować klucze API i jakie działania możesz wykonać.

1. Co to jest API?

API, czyli „Interfejs Programowania Aplikacji”, to zbiór instrukcji, za pomocą których platforma oferuje usługi innym platformom. Jest to strategiczny punkt dostępu dla zewnętrznych deweloperów, pozwalający na dostęp do określonej funkcjonalności lub danych w sposób ustrukturyzowany i bezpieczny. Jest to jak zestaw gotowych narzędzi, które ułatwiają tworzenie nowych aplikacji, usług czy kombinacji.

Krótko mówiąc, systeme.io otwiera się na inne platformy, aby oferować swoje usługi tam, gdzie przynosi to wartość dodaną.

2. Jak działa nasze publiczne API?

Nasze API udostępnia starannie wyselekcjonowany zestaw funkcji, umożliwiając deweloperom przejrzystą i efektywną interakcję z naszą platformą. Jeśli chcesz dowiedzieć się więcej o jego działaniu, możesz przeczytać naszą oficjalną dokumentację API.

3. Jak wygenerować klucze API

Klucze API są unikalnymi identyfikatorami, które uwierzytelniają żądania do naszego publicznego API. Umożliwiają programowy dostęp i zarządzanie różnymi zasobami na naszej platformie.

Aby utworzyć publiczny klucz API, kliknij swoje zdjęcie profilowe, wybierz Ustawienia (1), a następnie przewiń w dół do MCP & Publiczne klucze API (2).

Kliknij Utwórz (3) aby rozpocząć tworzenie publicznego klucza API.

W wyświetlonym oknie „Utwórz publiczny klucz API”, wprowadź nazwę oraz wybierz datę i godzinę wygaśnięcia klucza API.

Po zakończeniu, kliknij Zapisz (4).

Uwaga: Aby klucz API był aktywny na czas nieokreślony, zostaw pole 'Wygaśnięcie' puste.

Twój klucz jest teraz gotowy.

4. Co możesz zrobić z naszym API?

Nasze API otwiera wiele interesujących możliwości. Poniżej znajdują się główne działania, które możesz wykonać korzystając z naszego publicznego API:

a. Kontakty, tagi i niestandardowe pola:

• Zarządzaj kontaktami: Twórz nowe kontakty, aktualizuj istniejące, listuj swoją publiczność za pomocą zaawansowanych filtrów lub usuwaj kontakty.
• Zarządzaj tagami: Twórz, przypisuj, listuj i usuwaj tagi z kontaktów.
• Niestandardowe pola: Pobieraj dostępne niestandardowe pola kontaktu i ich identyfikatory (slugi) do poprawnego wypełniania informacji o kontakcie.

b. Newslettery:

• Tworzenie i aktualizacja newsletterów: Twórz nowe wersje robocze newsletterów lub częściowo aktualizuj istniejące. Możesz zdefiniować typ edytora (klasyczny lub wizualny), pobrać pełną zawartość HTML oraz wyraźnie określić imię i adres e-mail nadawcy.
• Przeglądaj i pobieraj: Przeglądaj istniejące newslettery lub pobierz pełną zawartość konkretnego newslettera używając jego ID.

c. Lejki sprzedażowe i edytor stron:

• Zarządzaj lejkowaniem sprzedażowym: Twórz nowe lejki, dodawaj nowe kroki (strony) do nich i pobierz listę wszystkich poszczególnych kroków w określonym lejku.
• Edytor stron: Zapisuj wygenerowaną zawartość strony bezpośrednio w krokach lejka sprzedażowego lub stronach witryny (pełne zastąpienie) i pobieraj schematy JSON dla określonych typów stron.

d. Plany cenowe i kupony:

• Tworzenie, edytowanie i usuwanie: Generowanie nowych planów cenowych i kuponów lub częściowe zaktualizowanie i usuwanie istniejących.
• Przegląd i wyszukiwanie: Przeglądaj wszystkie istniejące plany cenowe i kupony lub pobierz określone pozycje według ich ID.

e. Kursy i studenci:

• Zarządzaj kursami i studentami: Pobierz listę istniejących kursów i uzyskaj listę studentów aktualnie zapisanych.
• Zapisuj studentów: Programowo zapisuj kontakty na swoje pojedyncze kursy.

Uwaga dotycząca kursów: Wsparcie dla pakietów kursów zostanie dodane w przyszłych aktualizacjach.

f. Społeczności:

• Zarządzaj społecznościami: Pobierz listę istniejących społeczności i uzyskaj dostęp do listy bieżących członków w określonej społeczności.
• Zaproś członków: Programowo zapraszaj nowych użytkowników do dołączenia do twoich społeczności, podając ich ID kontaktu.

g. Reguły automatyzacji:

• Zarządzaj regułami: Programowo łącz wspólne zdarzenia i akcje, aktualizuj istniejące reguły (np. zmieniając akcję, zachowując ten sam wyzwalacz) lub miękko usuwaj reguły.
• Przeglądaj i pobieraj: Przeglądaj swoje reguły automatyzacji lub pobierz konkretną regułę, używając jej ID.

h. Subskrypcje:

• Zarządzaj subskrypcjami: Pobierz listę wszystkich zasobów w subskrypcji z platform trzecich i anuluj subskrypcję albo natychmiast, albo na końcu cyklu rozliczeniowego.

i. Webhooki

• Zarządzaj webhookami: Programowo twórz nowe webhooki do otrzymywania powiadomień w czasie rzeczywistym, pobierz listy istniejących webhooków i usuń te, które nie są już potrzebne.

Uwagi:

• Aby łatwo identyfikować i zarządzać tokenami, każdy musi mieć unikalną nazwę.
• Token można skopiować tylko natychmiast po jego utworzeniu. Jeśli zapomniałeś skopiować swój token, usuń go i utwórz nowy.
• Jako środek bezpieczeństwa, wyślemy powiadomienie e-mail, gdy nowy publiczny klucz API zostanie utworzony na twoim koncie systeme.io.
• Możesz utworzyć do 3 kluczy API na jedno konto.

Dowiedz się więcej: Dokumentacja API.