Załączniki graficzne

Wysyłaj obrazy razem z powiadomieniami. Załączniki wyświetlają się w aplikacji webowej, mobilnej oraz jako podgląd w powiadomieniach push na iOS i Androidzie.

Tylko tematy prywatne

Załączniki graficzne są dostępne wyłącznie na tematach prywatnych. Dowiedz się więcej o tematach prywatnych →

Wysyłanie załączników

Upload przez formularz (multipart)

Najczęstsza metoda - używana przez aplikację webową i integracje:

curl -F "message=Zrzut ekranu dashboardu" \
  -F "title=Alert CPU" \
  -F "attachment=@screenshot.png" \
  -H "X-API-Key: noti_twoj_klucz" \
  https://app.notifer.io/twoj-temat

Upload binarny (curl -T)

Wyślij plik obrazu bezpośrednio jako treść żądania. Wiadomość i tytuł przekaż przez nagłówki:

curl -T /sciezka/do/obraz.jpg \
  -H "X-API-Key: noti_twoj_klucz" \
  -H "X-Message: Dashboard Grafana" \
  -H "X-Title: Raport dzienny" \
  -H "X-Filename: dashboard.jpg" \
  https://app.notifer.io/twoj-temat

Obraz z URL (X-Attach)

Notifer pobierze obraz z podanego URL i dołączy go do wiadomości:

curl -d "Wykryto alert na dashboardzie" \
  -H "X-API-Key: noti_twoj_klucz" \
  -H "X-Attach: https://grafana.example.com/render/dashboard.png" \
  https://app.notifer.io/twoj-temat

informacja

Serwer pobiera obraz z URL (timeout: 15 sekund). Obsługiwane są adresy HTTP i HTTPS.

Obsługiwane formaty

Format	Typ MIME	Maks. wymiary
JPEG	image/jpeg	4096 x 4096
PNG	image/png	4096 x 4096
GIF	image/gif	4096 x 4096
WebP	image/webp	4096 x 4096

Pliki są walidowane na podstawie magic bytes (rzeczywista zawartość pliku), a nie tylko rozszerzenia.

Limity w zależności od planu

Wszystkie plany obsługują ten sam maksymalny rozmiar pliku: 15 MB. Plany różnią się dziennym transferem:

Plan	Maks. rozmiar pliku	Dzienny transfer
Free	15 MB	500 MB
Essentials	15 MB	2 GB
Team	15 MB	5 GB

Nie ma limitu liczby uploadów dziennie — liczy się tylko łączny transfer.

Po przekroczeniu limitu API zwraca 429 Too Many Requests z nagłówkami rate limit.

Format odpowiedzi

Gdy wiadomość zawiera załącznik, odpowiedź zawiera obiekt attachment:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "topic": "twoj-temat",
  "message": "Zrzut ekranu dashboardu",
  "title": "Alert CPU",
  "attachment": {
    "id": "7a3b5c1d-2e4f-6a8b-9c0d-1e2f3a4b5c6d",
    "name": "screenshot.png",
    "type": "image/png",
    "size": 275485,
    "width": 1920,
    "height": 1080,
    "url": "/api/attachments/7a3b5c1d-2e4f-6a8b-9c0d-1e2f3a4b5c6d",
    "thumbnail_url": "/api/attachments/7a3b5c1d-2e4f-6a8b-9c0d-1e2f3a4b5c6d/thumb",
    "expires_at": "2026-03-30T06:00:00Z"
  }
}

Miniaturki

Miniaturka WebP (maks. 400x400px) jest automatycznie generowana dla każdego uploadu. Miniaturki są używane na listach wiadomości i w podglądach powiadomień push.

Wygasanie

Załączniki wygasają po 12 godzinach i są automatycznie usuwane. Pole expires_at w odpowiedzi wskazuje, kiedy obraz nie będzie już dostępny.

ostrzeżenie

Załączniki są tymczasowe z założenia. Jeśli potrzebujesz trwałego przechowywania, zapisz obraz osobno zanim wygaśnie.

Podgląd w powiadomieniach push

Gdy wiadomość z załącznikiem wywołuje powiadomienie push:

• iOS: Obraz wyświetla się jako podgląd (widoczny po rozwinięciu powiadomienia)
• Android: Obraz wyświetla się w stylu big picture

Nie wymaga dodatkowej konfiguracji - działa automatycznie.

Przykłady zastosowań

Alert Grafana ze zrzutem dashboardu

curl -d "Wykryto wysokie zużycie CPU na prod-web-01" \
  -H "X-API-Key: noti_twoj_klucz" \
  -H "X-Title: Alert CPU" \
  -H "X-Priority: 2" \
  -H "X-Tags: grafana,cpu,warning" \
  -H "X-Attach: https://grafana.internal/render/d/cpu-dashboard?width=800&height=400" \
  https://app.notifer.io/alerty-serwera

Błąd buildu CI/CD

curl -F "message=Build #1234 nie powiódł się - zobacz zrzut ekranu" \
  -F "title=Build Failed" \
  -F "priority=2" \
  -F "tags=ci,build,failure" \
  -F "attachment=@build-error.png" \
  -H "X-API-Key: noti_twoj_klucz" \
  https://app.notifer.io/ci-notifications

Alert kamery bezpieczeństwa

curl -T /tmp/ruch-wykryty.jpg \
  -H "X-API-Key: noti_twoj_klucz" \
  -H "X-Message: Wykryto ruch przy drzwiach wejściowych" \
  -H "X-Title: Alert bezpieczeństwa" \
  -H "X-Priority: 1" \
  -H "X-Filename: ruch.jpg" \
  https://app.notifer.io/bezpieczenstwo