KIEDY ZAMYKA SIĘ RYNEK KRYPTOWALUTCENA KRYPTOWALUTY 0X0DOŁADOWANIA KRYPTOWALUT(1.0.0)

Wykonawcy współpracujący z firmą Emotivo mają do dyspozycji narzędzia wspomagające prace z voucherami oraz rezerwacjami. Obecnie dysponujemy trzema narzędziami, za pomocą których, można przeprowadzić czynności takie jak: sprawdzenie vouchera, dokonanie rezerwacji, ustawienia daty rezerwacji, anulowanie rezerwacji, realizację usługi oraz finalne rozliczenia. Są to:

• aplikacja mobilna,
• aplikacja www,
• API.

Aplikacja mobilna oraz aplikacja www są tożsame, jeśli chodzi o funkcjonalności. W przypadku API, wykonawcy będą mogli używać endpointów do wszystkich funkcjonalności jak w dwóch pierwszych aplikacjach z wyjątkiem obszaru rozliczeń. Nasze systemy są unowocześniane - a wraz z nimi aplikacje, dlatego też pozostałe funkcjonalności w API będą pojawiać się w kolejnych wydaniach. Jeśli chcesz już dziś podzielić się z nami swoją opinią na temat naszego API - daj nam znać na adres arch_dev@emotivo.pl

Proces rezerwacji z perspektywy wykonawcy jest dość prosty, osoba obdarowana powinna pobrać dane o wykonawcy z systemów Emotivo a następnie skontaktować się z wybranym wykonawcą w celu umówienia rezerwacji. Pobranie danych o wykonawcy nie jest wymagane, osoba obdarowana może udać się do wykonawcy, bądź skontaktować z wykonawcą bez uprzedniego pobrania danych z systemów Emotivo.

Potwierdzenie terminu realizacji usługi - czyli rezerwacja - powinna być odłożona w systemie co będzie skutkowało zmianą stanu vouchera na "w rezerwacji". Wykonawca ma możliwość dodania do rezerwacji informacji o planowanej dacie realizacji, ale to też nie jest wymagane.

W momencie gdy voucher jest zarezerwowany, wykonawca ma możliwość odwołania rezerwacji, co skutkować będzie możliwością ponownego wejścia w proces.

Realizacja to zdarzenie które musi być zapisane w systemie, ponieważ na tej podstawie jesteśmy w stanie poprawnie wejść w podproces związany z rozliczeniem. Rozliczenie na ten moment jest obsługiwane z poziomu aplikacji mobilnej oraz aplikacji www.

Poniższy dokument stanowi dokumentację API dla wykonawców Emotivo. Udostępnia ono podstawowe operacje, które mogą być wykonane na voucherach z perspektywy wykonawcy czyli m.in. sprawdzenie vouchera, rezerwację vouchera, realizację vouchera oraz dodanie planowanej daty realizacji.

API dostępne jest pod adresem: https://api.emotivo.tech/v1/.

Lista kodów statusu HTTP, które mogą być zwrócone przez API:

• 200 (OK) - zwracany w sytuacji poprawnego wykonania zapytania dla metod GET, PUT, PATCH lub DELETE
• 201 (Created) - zwracany po poprawnym utworzeniu zasobu (może być zwrócony wyłącznie gdy metoda zapytania to POST)
• 400 (Bad Request) - zwracany w sytuacji błędu występującego w danych (np. błędy format danych w body, nieznany parametr w query, nieprawidłowy typ pola w body/query itp)
• 401 (Unauthorized) - zwracany gdy dane uwierzytelniające są nieprawidłowe (np. błędny lub nieważny token API, błędne dane logowania)
• 404 (Not found) - zwracany w sytuacji gdy żądany zasób nie istnieje
• 409 (Conflict) - zwracany w sytuacji wystąpienia błędu w logice biznesowej aplikacji (np. rezerwacja zablokowanego vouchera)
• 500 (Internal Server Error) - zwracany w przypadku wystąpienia błędu wewnętrznego który nie pozwala na poprawne wykonanie zapytania (np. wystąpienie wyjątku, błąd w komunikacji z bazą danych, błąd w komunikacji z innym serwisem).

Rodzaje kodów:

• 1xxx - Kody informacyjne zwracane w przypadku powodzenia danej operacji. Mogą być zwrócone tylko z kodami HTTP 200 (OK), 201 (Created).
• 2xxx - kody opisujące błędy spowodowane nieprawidłowym zapytaniem. Muszą być zwrócone z kodami HTTP 400 (Bad Request), 401 (Unauthorized), 404 (Not found).
• 3xxx - kody opisujące błędy spowodowane niespełnieniem zasad logiki biznesowej. Muszą być zwrócone z kodem HTTP 409 (Conflict).
• 4xxx - kody opisujące wewnętrzne błędy w aplikacji. Mogą być zwrócone z kodem HTTP 500 (Internal Server Error).

Poniższa tabela przedstawia listę kodów, które mogą być zwrócone przez API w polu messages.