Projekt demonstracyjny — firma, opinie i liczby są fikcyjne. Wróć do portfolio
Pulsar API v2.4
Dokumentacja dla programistów

Pulsar API v2.4

REST API do wysyłki i śledzenia powiadomień transakcyjnych: e-mail, SMS i push z jednego endpointu.

https://api.pulsar.dev/v2 Status: operational Średni czas odpowiedzi: 84 ms

Szybki start

Pierwsza wiadomość wychodzi w trzy minuty. Wybierz język, skopiuj i podmień klucz.

cURL
curl -X POST https://api.pulsar.dev/v2/messages \
  -H "Authorization: Bearer psk_live_9f2c..." \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "to": "anna@firma.pl",
    "template": "order-shipped",
    "data": { "order_id": "PL-10428" }
  }'

Uwierzytelnianie

Każde zapytanie wymaga nagłówka z kluczem projektu. Klucze psk_test_ działają tylko w piaskownicy i nie wysyłają realnych wiadomości.

Nagłówki
Authorization: Bearer psk_live_9f2c4d1a8b7e6f5c
Content-Type: application/json

Endpointy

Kliknij endpoint, żeby rozwinąć parametry i przykładową odpowiedź.

Parametry

NazwaTypWymaganyOpis
channelstringtak„email", „sms" albo „push".
tostringtakAdres e-mail, numer telefonu lub token urządzenia.
templatestringtakIdentyfikator szablonu z panelu.
dataobjectnieZmienne wstawiane do szablonu.
send_atstringnieData ISO 8601 — wysyłka zaplanowana.

Przykładowa odpowiedź

200 OK · application/json
{
  "id": "msg_01HZK4T8QF",
  "status": "queued",
  "channel": "email",
  "created_at": "2026-08-10T09:14:22Z"
}

Kody błędów

Każdy błąd zwraca pole code — to na nim buduj logikę, nie na treści komunikatu.

HTTPcodeZnaczenie i co z tym zrobić
401invalid_api_key

Klucz nie istnieje, wygasł lub użyto klucza testowego na produkcji.

→ Sprawdź prefiks klucza: psk_live_ dla produkcji, psk_test_ dla piaskownicy.

404template_not_found

Szablon o podanym identyfikatorze nie istnieje w tym projekcie.

→ Pobierz listę z GET /templates — identyfikatory są zależne od projektu.

422missing_variable

Szablon oczekuje zmiennej, której nie było w polu data.

→ Odpowiedź zawiera pole variables z listą brakujących kluczy.

429rate_limited

Przekroczono limit zapytań dla klucza.

→ Ponów zapytanie po czasie z nagłówka Retry-After, najlepiej z wykładniczym backoffem.

503channel_unavailable

Operator kanału chwilowo nie przyjmuje ruchu.

→ Wiadomość zostaje w kolejce — nie wysyłaj jej ponownie, sprawdzaj status.

Limity zapytań

Aktualne zużycie znajdziesz w nagłówkach X-RateLimit-* każdej odpowiedzi.

Sandbox

60 zapytań

na minutę

Burst
100
Wsparcie
dokumentacja

Start

600 zapytań

na minutę

Burst
1 000
Wsparcie
e-mail, 24 h

Scale

6 000 zapytań

na minutę

Burst
10 000
Wsparcie
e-mail, 4 h

Enterprise

indywidualnie

na minutę

Burst
indywidualnie
Wsparcie
dedykowany kanał

Changelog

  1. v2.4

    2026-07-28
    • · Nowy kanał push dla aplikacji mobilnych
    • · Pole send_at — wysyłka zaplanowana
  2. v2.3

    2026-05-14
    • · Paginacja kursorowa na GET /messages
    • · Podpis HMAC webhooków
  3. v2.2

    2026-02-03
    • · Endpoint PATCH /contacts/{id}
    • · Limity zapytań widoczne w nagłówkach odpowiedzi

© 2026 Pulsar API — dokumentacja demonstracyjna. Wszystkie endpointy i klucze są fikcyjne.