Obraz funkcji bloga VTAP

Pierwsze kroki z VTAP API Designer – część 2

Wcześniej w naszej serii blogów Vtiger Application Platform (VTAP) omawialiśmy, jak dostosować interfejs Vtiger i wprowadzić niestandardowe przyciski i widżety, aby zaspokoić określone potrzeby biznesowe. To tylko jedna z możliwości oferowanych przez platformę. VTAP daje Ci wiele takich funkcji, które pomagają:
  • Utwórz niestandardowy interfejs API REST
  • Połącz się z innymi aplikacjami, które mają REST API dostępne
  • Połącz się z aplikacjami obsługującymi OAuth
W tym blogu omówię, w jaki sposób możemy stworzyć niestandardowe API REST. Najpierw pozwól, że porozmawiam trochę o interfejsach API Vtiger REST. Dostęp do niego można uzyskać za pomocą poniższego punktu końcowego, który będzie specyficzny dla Twojej instancji CRM. Na przykład,https://your_instance.odx.vtiger.com/restapi/v1/vtiger/default Jeśli znasz Vtiger Reszta API, możesz pominąć poniższą sekcję. Aby dowiedzieć się o dostępnych modułach, możesz użyć typy list API. Oto zrzut ekranu pokazujący, jak uzyskać dostęp do interfejsu API za pomocą klienta listonosza. Obraz podrzędny-1 Vtiger zapewnia już standardowy zestaw interfejsów API, ale dzięki nowemu narzędziu API Designer możesz teraz pisać własne niestandardowe interfejsy API REST. Projektant API API Designer udostępnia programistom środowisko pracy do tworzenia interfejsów API opartych na protokole HTTP, które mogą być udostępniane w środowisku wykonawczym VTAP lub aplikacji zewnętrznej w celu łatwej integracji. API można zdefiniować za pomocą VADL specyfikacje. Dostęp API wymaga autoryzacji użytkownika i jest zgodny ze standardową konfiguracją dostępu do rekordów dokonaną w CRM. Projektant API udostępnia IDE do pisania niestandardowych interfejsów API. Jeśli piszesz niestandardowy interfejs API REST dla konkretnego modułu, musisz nazwać interfejs API i wybrać moduł. Obraz podrzędny-2 Zdefiniowaliśmy język definicji aplikacji Vtiger (VADL), który opiera się na składni XML, aby umożliwić początkującym administratorom lub programistom zdefiniowanie interfejsu API bez wiedzy programistycznej. VADL pozwala Ci na:
  • Zdefiniuj twaróg
    • API (Create, Update, Retrieve, Delete) na modułach encji
    • Wywołaj punkt końcowy oparty na HTTP (REST / SOAP) za pomocą metod (GET/POST/PUT/DELETE)
      • Z uwierzytelnianiem (podstawowe / oparte na tokenie okaziciela)
    • Zaakceptuj parametry żądania i powiąż jako dane wejściowe API
Weźmy przykład tworzenia niestandardowego interfejsu API REST, który będzie wyszukiwał kontakty pasujące do domeny poczty e-mail. Dodamy nowy interfejs API o nazwie „fetch_email_contact” i wybierzemy moduł Kontakty. Kod-pod-obraz-1 Wszystkie definicje są umieszczone wewnątrz an API węzeł ze standardowym typem HTTP (get, post, put i delete). Ponieważ pobieramy dane z CRM, użyjemy wybierz węzły i przekazać nazwy modułów. Będziemy mieć pola, które trzeba będzie pobrać wewnątrz węzeł rekordów i wszelkie warunki filtrowania wewnątrz gdzie węzeł. Obsługujemy różne rodzaje Warunki jak równe, nie równe, jak, większe niż, mniejsze niż itp. Powyżej jest prostym przykładem, który można również osiągnąć za pomocą istniejącego pytanie REST API. Prawdziwa moc staje się widoczna, gdy połączysz wiele interfejsów API w jeden. Rozważ ten przykład. Aktualizujesz rekord, jeśli istnieje, lub tworzysz, jeśli nie istnieje. Jeśli używasz istniejącego interfejsu API, do wykonania tych operacji będzie potrzebnych wiele wywołań. Ale korzystając z API Designer, możesz połączyć te operacje w jedno wywołanie interfejsu API.   Kod-pod-obraz-2 W powyższym przykładzie umieszczamy definicję wewnątrz upierać się węzeł. Obejmuje to aktualizacja i Stwórz węzeł, który zaktualizuje rekord, jeśli istnieje, lub utworzy rekord, jeśli nie istnieje. Aby zidentyfikować rekord, który wymaga aktualizacji, możesz użyć miejsca, w którym możesz filtrować i znaleźć odpowiednie wpisy. Na końcu definicji węzeł zwrotny odeśle zdefiniowane pola do klienta. Możesz zapisać i opublikować te interfejsy API, aby udostępnić je aplikacjom zewnętrznym oraz wewnętrznemu środowisku wykonawczemu VTAP. Uzyskiwanie dostępu do niestandardowego interfejsu API opublikowanego za pomocą API Designer
  • Aby uzyskać dostęp do dowolnego niestandardowego interfejsu API opublikowanego za pomocą API Designer, musisz użyć poniższego punktu końcowego.
  • https://your_instance.odx.vtiger.com/restapi/V1/ApiDesigner/api/API_NAME?PARAMETRY?
  • API_NAME należy zastąpić nazwą nadaną API. Upewnij się również, że używasz odpowiedniego typu HTTP i kwalifikacje(nazwa użytkownika i klucz dostępu), aby uzyskać do niego dostęp.
Dostęp do niedawno utworzonego fetch_email_contact API przy użyciu listonosza
  • Aby uzyskać dostęp do ostatnio utworzonego fetch_email_contact API przy użyciu listonosza, powinieneś użyć poniższego.
  • https://your_instance.odx.vtiger.com/restapi/V1/ApiDesigner/api/fetch_email_contact?domain=%vtiger.com%
Obraz podrzędny-3 Dostęp do tych interfejsów API można uzyskać wewnętrznie w Projektancie modułów za pomocą interfejsu API środowiska wykonawczego VTAP VTAP.CustomApi.Get do wyświetlania wewnątrz widżetu lub niestandardowych stron w interfejsie użytkownika Vtiger. Obraz widżetu Podsumowując, zobaczyliśmy, jak narzędzie API Designer umożliwia pisanie niestandardowych interfejsów API REST i używanie ich wewnętrznie oraz w innych aplikacjach do płynnego korzystania z danych CRM. W przypadku innych pytań wyślij wiadomość e-mail na adres platform@vtiger.com. Zarejestruj się w wersji dla programistów tutaj.
Prawa autorskie 2021 Vtiger | Polityka prywatności | Centrum zasad i prawa