W tym dokumencie znajdziesz przewodnik krok po kroku, jak opublikować integrację z Twoim serwisem w Altegio Marketplace. W kontekście marketplace każda integracja nazywana jest «aplikacją».
KROK 1 — Utwórz swoją pierwszą aplikację
- Uzyskaj dostęp do konta dewelopera pod tym linkiem. Uwaga: narzędzia deweloperskie są dostępne tylko na koncie, z którego je utworzyłeś.
- Na koncie dewelopera utwórz swoją pierwszą aplikację dla marketplace.
KROK 2 — Zintegruj się z API marketplace
- Zaimplementuj żądanie podłączenia aplikacji do lokalizacji użytkownika.
- Zaimplementuj przekazywanie danych o płatnościach Twojego serwisu.
- Zaimplementuj obsługę webhooka o odłączeniu integracji po stronie Altegio.
KROK 2.5 — Przetestuj w swojej lokalizacji przed moderacją
Przed wysłaniem aplikacji do moderacji zainstaluj wersję roboczą w lokalizacji, którą zarządzasz, i wykonaj prawdziwe wywołania API. To self-service — bez moderacji.
- Na koncie dewelopera otwórz «General info» aplikacji i skopiuj «Link to request a review» (zob. Generowanie linku do aplikacji).
- Otwórz ten link jako administrator swojej testowej lokalizacji i kliknij «Podłącz». Aplikacja zostanie powiązana z lokalizacją w stanie pending.
- Z Twojego serwisu wyślij żądanie podłączenia w ciągu 1 godziny, aby aktywować powiązanie — zob. Podłączanie integracji przez marketplace.
- Upewnij się, że aplikacja jest w stanie active, i zacznij wywoływać API lokalizacji z tokenem użytkownika systemowego.
Dokładne endpointy, tokeny, hosty i gotowe do skopiowania przykłady znajdziesz w przewodniku dla deweloperów Install & test your app before moderation.
KROK 3 — Przejdź moderację aplikacji
Aby opublikować aplikację w Altegio Marketplace, musisz przejść moderację. Po utworzeniu w karcie aplikacji pojawi się sekcja «Publikacja» z listą kontrolną, która pomoże przygotować aplikację do moderacji.
W ramach moderacji pracownicy Altegio sprawdzą, czy Twoja aplikacja:
- Poprawnie łączy się z lokalizacją klienta.
- Przekazuje dane o płatnościach.
- Przekazuje dane o zwrotach płatności.
- Poprawnie obsługuje odłączenie i ponowne podłączenie integracji.
- Poprawnie obsługuje podłączenie integracji, gdy użytkownik jest już zarejestrowany w Twoim systemie.
Po zakończeniu prac nad integracją z API marketplace i przetestowaniu jej działania po swojej stronie wypełnij pola listy kontrolnej. Przycisk «Wyślij do moderacji» stanie się dostępny po wypełnieniu pól obowiązkowych.
Szczegółowa instrukcja dotycząca moderacji znajduje się tutaj.
Gdy Altegio zakończy weryfikację, a wszystkie wykryte błędy zostaną usunięte, Twoja integracja stanie się dostępna dla użytkowników w marketplace w wybranej przez Ciebie kategorii.