// Open Source / Java

Dotykacka Java API
v2 Client

Biblioteka Java do integracji z Dotykacka — chmurowym systemem POS dla restauracji, kawiarni i sklepów. Obsługuje pełne CRUD, automatyczne tokeny, ETAG i operacje batch.

Zobacz na GitHub Jak zacząć?
dotykacka-java-api-v2-client to open-source'owa biblioteka Java stworzona przez Grizzly Software, która upraszcza integrację z Dotykacka API 2.x. Klient jest zorientowany na Cloud/tenant — dla każdego zarządzanego Clouda tworzysz dedykowaną instancję klienta. Zamiast samodzielnie zarządzać autoryzacją, odświeżaniem tokenów i obsługą ETAG — importujesz jedną zależność Maven i operujesz na gotowych fasadach serwisowych. Licencja MIT. Dostępna na GitHub i w Maven Central.
// Możliwości

Co oferuje biblioteka?

Auth

Automatyczna autoryzacja

Klient uwierzytelnia się w API za pomocą refresh tokena, uzyskuje access token i przechowuje go w AccessTokenProvider. Token jest dołączany do każdego żądania i automatycznie odnawiany po wygaśnięciu.

CRUD

Fasady serwisowe

Gotowe fasady CRUD dla encji Dotykacka: produkty, zamówienia, klienci, pracownicy, kategorie, dostawcy, magazyny, rezerwacje, stoliki, tagi, grupy rabatowe i inne. Każda fasada oferuje metody create, update, patch, delete, get i getAll.

Concurrency

Obsługa ETAG

Wbudowana obsługa nagłówków ETAG. Przy pobieraniu obiektów etag jest automatycznie przypisywany do encji. Przy aktualizacji wartość etag trafia do nagłówka If-Match, co chroni przed nadpisaniem danych przez równoległe żądania.

Performance

Operacje batch

Efektywne przetwarzanie dużych zbiorów danych dzięki operacjom wsadowym. Mniej żądań HTTP, lepsza wydajność przy masowym tworzeniu lub aktualizacji rekordów.

// Szybki start

Instalacja

Dostępne w Maven Central. Dodaj zależność do swojego projektu.

Maven

pom.xml

Dodaj do sekcji <dependencies> w pliku pom.xml:

  • groupId: pl.grizzlysoftware
  • artifactId: dotykacka-java-api-v2-client
  • version: 1.0.0
Maven Central →
Gradle

build.gradle

Dodaj do sekcji dependencies w pliku build.gradle:

  • group: pl.grizzlysoftware
  • name: dotykacka-java-api-v2-client
  • version: 1.0.0
GitHub README →
// Szczegóły techniczne

Wymagania i dostępne serwisy

Wymagania

Stack techniczny

  • Java 11
  • Gradle 7.2 (wrapper w repozytorium)
  • Refresh token z portalu Dotykacka
  • Cloud ID (identyfikator tenanta)
Serwisy

Dostępne fasady

  • Produkty, składniki i customizacje
  • Zamówienia i pozycje zamówień
  • Klienci, pracownicy, dostawcy
  • Kategorie, tagi, grupy rabatowe
  • Magazyny i oddziały magazynów
  • Rezerwacje, stoliki, logi kasowe
  • Cloud, oddziały, podmioty EET
// Open Source

MIT License

Biblioteka jest dostępna na licencji MIT — możesz jej używać w projektach komercyjnych i niekomercyjnych bez ograniczeń. Kod źródłowy, issues i pull requesty na GitHub.

Otwórz repozytorium na GitHub Masz pytanie?
// Kontakt

Gotowy na rozmowę
o Twoim projekcie?

Opisz nam swój problem lub cel biznesowy. Odpiszemy w ciągu jednego dnia roboczego z wstępną oceną i pytaniami, które pomogą nam przygotować rzetelną wycenę.

Napisz do nas →

Nie chcesz pisać maila albo czekać na odpowiedź?
Wpadnij na naszego Discorda — pogadamy na luzie, bez zbędnych formalności.

Pogadajmy na Discordzie →

Email

hello@levitatingapes.com

Lokalizacja

Polska / Remote

Odpowiedź

do 24h roboczych