Przejdź do treści

Podstawowe koncepcje

Zrozumienie kluczowych koncepcji w Notifer pomoże Ci efektywnie korzystać z usługi.

Tematy

  • Tematy to kanały dla wiadomości. Pomyśl o nich jak o pokojach czatowych lub kanałach RSS.
  • Nazwy tematów są częścią URL: https://app.notifer.io/my-topic
  • Tematy muszą być utworzone jawnie przed publikowaniem wiadomości
  • Twórz tematy przez aplikację webową lub API
  • Każdy może przeglądać publiczne tematy bez uwierzytelnienia
  • Prywatne tematy wymagają uwierzytelnienia

Zasady nazewnictwa tematów

  • Używaj małych liter, cyfr, myślników i podkreślników
  • Długość: 3-64 znaki
  • Przykłady: server-alerts, my_notifications, app123-status

Typy tematów

# Każdy może publikować i subskrybować
curl -d "Public announcement" https://app.notifer.io/announcements
  • Widoczny w przeglądarce publicznych tematów o ile tak ustawił właściciel
  • Nie wymaga uwierzytelnienia
  • Świetny do powiadomień społecznościowych, lub treści bez danych wrażliwych

Prywatne tematy wymagają uwierzytelnienia do publikowania. Subskrypcja wymaga zgody właściciela lub odkrywalności:

# Wymaga klucza API lub logowania
curl -d "Confidential data" \
  -H "X-API-Key: noti_your_key_here" \
  https://app.notifer.io/private-alerts
  • Pełna kontrola dostępu
  • Subskrypcja wymaga zgody właściciela (domyślnie)
  • Opcjonalnie odkrywalny - umożliwia publiczne subskrypcje tylko do odczytu

Tematy prywatne mogą być ustawione jako odkrywalne w publicznym katalogu, umożliwiając subskrypcje tylko do odczytu:

# Tylko właściciel/posiadacze tokenów mogą publikować
curl -d "Ogłoszenie firmowe" \
  -H "X-API-Key: noti_your_key_here" \
  https://app.notifer.io/announcements
  • Każdy może znaleźć i subskrybować przez katalog
  • Subskrybenci otrzymują powiadomienia (tylko odczyt)
  • Tylko właściciel i posiadacze tokenów mogą publikować
  • Idealne dla ogłoszeń i aktualizacji statusu

Wiadomości

Wiadomości to powiadomienia wysyłane do tematów.

Struktura wiadomości

{
  "id": "msg_abc123",
  "topic": "my-topic",
  "title": "Optional Title",
  "message": "Message content",
  "priority": 3,
  "tags": ["tag1", "tag2"],
  "timestamp": "2025-11-02T10:30:00Z"
}

Parametry wiadomości

Parametr Opis Domyślnie Przykład
message Treść wiadomości (wymagane) - "Server is down"
X-Title Tytuł wiadomości Nazwa tematu "Alert"
X-Priority Poziom priorytetu 1-5 3 5 (pilny)
X-Tags Tagi oddzielone przecinkami [] "server,critical"

Poziomy priorytetów

Priorytet Opis Zastosowanie Ikona
1 Min Niska ważność, do wiadomości
2 Niski Drobne aktualizacje
3 Domyślny Standardowe powiadomienia
4 Wysoki Ważne alerty
5 Pilny Krytyczne problemy

Tagi

Tagi pomagają kategoryzować i filtrować wiadomości:

# Wiele tagów
curl -d "Database connection lost" \
  -H "X-Tags: database,error,production" \
  https://app.notifer.io/alerts

Funkcje tagów:

  • Filtruj subskrypcje według konkretnych tagów
  • Wyszukuj wiadomości po tagach
  • Wizualne wskaźniki w interfejsie

Odbieranie wiadomości

Aplikacja Web i mobilna (wymagane konto)

Aby przeglądać i odbierać wiadomości w aplikacji Notifer:

  1. Utwórz konto na app.notifer.io
  2. Zaloguj się do aplikacji web lub mobilnej
  3. Przeglądaj lub wyszukuj tematy
  4. Zasubskrybuj tematy, które chcesz śledzić

Powiadomienia push pozwalają otrzymywać alerty nawet gdy aplikacja jest zamknięta:

  • Włącz powiadomienia przeglądarki (web)
  • Zainstaluj aplikację mobilną dla powiadomień push iOS/Android

Dostęp programistyczny (bez konta dla publicznych tematów)

Deweloperzy mogą uzyskać dostęp do publicznych tematów bez uwierzytelnienia:

Strumieniowanie w czasie rzeczywistym dla aplikacji:

const eventSource = new EventSource('https://app.notifer.io/my-topic/sse');
eventSource.onmessage = (event) => {
  console.log(JSON.parse(event.data));
};

Strumieniowanie z wiersza poleceń:

notifer subscribe my-topic

Pobierz historię wiadomości:

curl https://app.notifer.io/my-topic/json

Prywatne tematy wymagają uwierzytelnienia

Dla prywatnych tematów musisz podać klucz API, token tematu lub token JWT.

Uwierzytelnianie

Co wymaga konta?

Akcja Publiczne tematy Prywatne tematy
Tworzenie tematów Wymagane konto Wymagane konto
Przeglądanie w aplikacji web/mobilnej Wymagane konto Wymagane konto
Subskrypcja (powiadomienia push) Wymagane konto Wymagane konto + uprawnienia dla tematów zespołowych
Publikowanie wiadomości Bez konta Wymagane uwierzytelnienie
Dostęp SSE/API (programistyczny) Bez konta Wymagane uwierzytelnienie

Metody uwierzytelniania

Dla skryptów i integracji:

curl -H "X-API-Key: noti_your_key_here" \
  -d "Automated message" \
  https://app.notifer.io/my-private-topic

Dla dostępu do konkretnego tematu (zalecane dla automatyzacji):

curl -H "X-Topic-Token: tk_your_token_here" \
  -d "Message" \
  https://app.notifer.io/my-private-topic

Dla aplikacji web/mobile po zalogowaniu:

curl -H "Authorization: Bearer your_jwt_token" \
  https://app.notifer.io/api/topics

Przechowywanie wiadomości

  • Wiadomości są przechowywane do 60 dni (w zależności od planu)
  • Ostatnie 100 wiadomości na temat jest cache'owanych dla natychmiastowego dostępu
  • Starsze wiadomości są dostępne przez paginację API

Limity

Limity różnią się w zależności od planu subskrypcji:

Plan Wiadomości/dzień Prywatne tematy Subskrypcje Retencja wiadomości
FREE 1 000 1 5 7 dni
ESSENTIALS 15 000 10 25 30 dni
TEAM 50 000 50 Bez limitu 60 dni

Zobacz Cennik po szczegóły.

Następne kroki