Przejdź do głównej treści

API

Grafika SVG api

Niniejsza dokumentacja opisuje dostępne endpointy API, ich parametry oraz przykładowe zapytania i odpowiedzi. API oferuje funkcje związane z informacjami o słońcu na podstawie współrzędnych geograficznych oraz konwersję tekstu w formacie Markdown na HTML. Poniżej znajdują się szczegóły dotyczące dostępnych zasobów.

Zapraszam do korzystania z API!

Moje API zostało stworzone, aby ułatwić dostęp do informacji o położeniu słońca oraz zapewnić wygodną konwersję tekstu w formacie Markdown na HTML. Jest łatwe w użyciu, szybkie i niezawodne. Niezależnie od tego, czy tworzysz aplikację pogodową, czy potrzebujesz dynamicznej konwersji treści, moje API spełni Twoje oczekiwania. Zapoznaj się z dokumentacją i rozpocznij korzystanie już dziś!

Endpointy

1. /api/date/suninfo

Opis

Endpoint zwraca informacje o słońcu (np. wschód, zachód) na podstawie podanego czasu oraz współrzędnych geograficznych.

Metoda

GET

Parametry

Nazwa Typ Opis
timestamp int Znacznik czasu w sekundach UNIX timestamp
latitude float Szerokość geograficzna
longitude float Długość geograficzna

Przykładowe zapytanie

GET /api/date/suninfo?timestamp=1710480000&latitude=52.2298&longitude=21.0122

Przykładowa odpowiedź

{
    "meta": {
        "timestamp": 1710480000,
        "longitude": 21.0122,
        "latitude": 52.2298
    },
    "data": {
        "sunrise": 1710478059,
        "sunset": 1710520892,
        "transit": 1710499476,
        "civil_twilight_begin": 1710476040,
        "civil_twilight_end": 1710522912,
        "nautical_twilight_begin": 1710473657,
        "nautical_twilight_end": 1710525294,
        "astronomical_twilight_begin": 1710471192,
        "astronomical_twilight_end": 1710527759
    }
}

2. /api/markdown/parse

Opis

Endpoint konwertuje tekst sformatowany w Markdown na HTML.

Metoda

POST

Parametry

Nazwa Typ Opis
markdown str Tekst w formacie Markdown

Przykładowe zapytanie

POST /api/markdown/parse
Content-Type: application/json

{
  "markdown": "# Nagłówek\n\nTo jest **przykładowy** tekst."
}

Przykładowa odpowiedź

{
  "data": "<h1>Nagłówek</h1><p>To jest <strong>przykładowy</strong> tekst.</p>"
}

Twoja prywatność i pliki cookies

  1. Ta strona internetowa wykorzystuje wyłącznie niezbędne pliki cookies, które są wymagane do jej prawidłowego działania – m.in. do poprawnego wyświetlania treści, zapamiętania podstawowych ustawień przeglądarki oraz zapewnienia stabilności serwisu.
  2. Nie stosuję plików cookies w celach marketingowych, reklamowych ani analitycznych.
  3. Strona ma charakter wyłącznie informacyjny i nie zawiera formularzy kontaktowych, rejestracyjnych ani zakupowych, przez które dane mogłyby być przesyłane na serwer.
  4. Nie zbieram danych osobowych podczas zwykłego korzystania z witryny.
  5. Serwis nie korzysta z certyfikatu SSL, jednak ze względu na informacyjny charakter strony nie jest wymagane przesyłanie poufnych danych. Zalecam jednak, aby nigdy nie wpisywać haseł ani danych osobowych na stronach bez szyfrowanego połączenia.
  6. Korzystając z tej strony, wyrażasz zgodę na używanie wyłącznie niezbędnych plików cookies.

Więcej informacji znajdziesz w mojej polityce prywatności.