Za programere

Poveži svoje aplikacije, skripte i automatizacije s DnevniMailom. Naš javni API omogućuje slanje bilješki i datoteka jednostavnim HTTP zahtjevima.

Uvod

DnevniMail omogućuje slanje bilješki na adrese korisnika bez registracije, prijave ili API ključa.

Adresa je predstavljena jedinstvenim identifikatorom od 32 heksadecimalna znaka. Identifikator možeš pronaći u postavkama DnevniMail računa.

Primjer identifikatora
272bfc71629b78a51e65f186863ceba1

API endpoint

Za slanje bilješke koristi HTTP POST zahtjev prema sljedećem endpointu.

POST https://posalji.dnevnimail.com.hr/

Parametri zahtjeva

API prima sljedeće parametre putem podataka HTTP obrasca.

Parametar Opis
address Identifikator jednog primatelja.
addresses[] Identifikatori više primatelja. Najviše 20.
title Naslov bilješke.
text Tekst bilješke.
date Neobavezan datum u formatu YYYY-MM-DD.
attachment Jedna neobavezna datoteka, najviše 10 MiB.

Potrebno je navesti barem naslov ili tekst. Nije potrebno ispuniti oba polja.

Slanje bilješke

Najjednostavniji zahtjev sadrži identifikator primatelja, naslov i tekst bilješke.

curl 
curl -X POST https://posalji.dnevnimail.com.hr/ \\
  -F "address=272bfc71629b78a51e65f186863ceba1" \\
  -F "title=Pozdrav!" \\
  -F "text=Ovo je bilješka poslana putem API-ja."
PHP - Symfony HttpClient 
$response = $httpClient->request(
    'POST',
    'https://posalji.dnevnimail.com.hr/',
    [
        'body' => [
            'address' => '272bfc71629b78a51e65f186863ceba1',
            'title' => 'Pozdrav!',
            'text' => 'Bilješka iz Symfony aplikacije.',
        ],
    ]
);
$statusCode = $response->getStatusCode();

Više primatelja

Jedan zahtjev može poslati istu bilješku na najviše 20 različitih adresa. 

curl -X POST https://posalji.dnevnimail.com.hr/ \\
  -F "addresses[]=PRVI_IDENTIFIKATOR" \\
  -F "addresses[]=DRUGI_IDENTIFIKATOR" \\
  -F "title=Obavijest" \\
  -F "text=Pozdrav svima!"

Svaki primatelj dobiva vlastitu bilješku. Brisanje kod jednog primatelja ne briše bilješke ostalih.

Slanje datoteka

API podržava slanje jedne datoteke uz bilješku. Vrsta datoteke nije ograničena, ali veličina ne smije prelaziti 10 MiB. 

curl -X POST https://posalji.dnevnimail.com.hr/ \\
  -F "address=272bfc71629b78a51e65f186863ceba1" \\
  -F "title=Dokument" \\
  -F "text=Dokument je u privitku." \\
  -F "attachment=@./dokument.pdf"
Priložene datoteke pohranjuju se privatno i dostupne su samo prijavljenom primatelju.

Zakazivanje bilješke

Bilješka se može poslati za današnji ili budući datum pomoću parametra date. 

curl -X POST https://posalji.dnevnimail.com.hr/ \\
  -F "address=272bfc71629b78a51e65f186863ceba1" \\
  -F "title=Podsjetnik" \\
  -F "text=Ne zaboravi sastanak." \\
  -F "date=2026-12-01"

Datum mora biti u formatu YYYY-MM-DD. API koristi UTC za provjeru datuma. Prošli datumi nisu dopušteni.

Odgovori i pogreške

Nakon obrade zahtjeva API vraća HTTP odgovor. Pri integraciji uvijek provjeri status odgovora prije nego što slanje označiš uspješnim.

Provjere kod neuspješnog zahtjeva
  • Je li identifikator ispravan?
  • Postoji li naslov ili tekst?
  • Je li datum valjan?
  • Ima li najviše 20 primatelja?
  • Je li datoteka unutar 10 MiB?

Sigurnost i privatnost

Javni API ne zahtijeva autentifikaciju. Svatko tko poznaje valjani identifikator može pokušati poslati bilješku na tu adresu.

Za slanje uvijek koristi HTTPS. Primljene bilješke dostupne su samo vlasniku računa.

Nemoj koristiti API za spam, masovno slanje neželjenih poruka ili automatizirane zahtjeve koji nepotrebno opterećuju servis.