Krótkie omówienie dostępnych API

Aby umożliwić Ci większą elastyczność przy opracowywaniu oprogramowania, w API Udemy Business mona używać funkcji integracji z zastosowaniem szeregu różnych metod.  W niniejszym artykule przedstawiamy niektóre z możliwych zastosowań w przypadku każdej z nich, a także zalecenia dotyczące tego, którą wybrać.

Spis treści

Kursy i wszystkie obiekty edukacyjne

API kursów GraphQL – Protokół: GraphQL 

  • Nowa generacja i ewolucja do tradycyjnych API kursów. W GraphQL, w przypadku każdego kursu, umożliwiamy pozyskiwanie jedynie tych metadanych kursu, które wskażesz. Dodatkowo stosowanie systemu zapytań GraphQL pozwala na wyszukiwanie kursów spełniających Twoje kryteria. 

Uwaga: Aby dowiedzieć się więcej o ogólnym rozwiązaniu, na którym opiera się działanie GraphQL, zajrzyj na stronę GraphQL Organization.

API dla wszystkich obiektów edukacyjnych GraphQL – Protokół: GraphQL 

  • Udemy oferuje wiele różnych sposobów na naukę, także poza kursami.  Eksponujemy wszystkie obiekty edukacyjne za pośrednictwem API w celu ich integracji z Twoim systemem.  Ten API pozwala na korzystanie z kursów, laboratoriów i odznak.  Tak, jak w przypadku innych usług GraphQL, możesz korzystać z zapytań, aby uzyskiwać interesujące Cię obiekty i pola.

Dokumentacja:  Aby uzyskiwać dokumentację GraphQL, musisz mieć dostęp do Udemy Business. Zajrzyj do Portalu dla programistów: https://{twoja_subdomena}.udemy.com/dev-portal/api-reference/

Raportowanie

API do raportowania – Protokół: RESTful 

  • Ten API zawiera wszystkie zgromadzone dane użytkowników dotyczące postępów, ukończonych etapów i działań w kontekście nauki.  Możesz wybrać otrzymywanie danych raportowych wszystkich użytkowników lub określić grupę użytkowników. Ze względu na ilość danych pojawiają się pewne opóźnienia w zakresie działań użytkowników, o których informacje mają być gromadzone i na temat których mają być tworzone raporty.

Dokumentacja: Dokumentacja interfejsów Udemy Business API – API typu RESTful

xAPI -– Protokół: xAPI

  • Raportowanie w czasie rzeczywistym poprzez webhook stworzony wedle standardów EdTech xAPI.  Udemy umożliwia przesyłanie danych o postępach oraz danych raportowania w czasie rzeczywistym.  Dane zawarte w tych zdarzeniach, o których informacja jest przekazywana w czasie rzeczywistym, obejmują mniejszy zakres w porównaniu do API do raportowania RESTful.

Dokumentacja: Dokumentacja xAPI Udemy Business

Ścieżki nauki

API do ścieżek nauki – Protokół: RESTful 

  • Udemy umożliwia uczestnikom kursów i administratorom L&D tworzenie ścieżek nauki, kolekcji zawierających po kilka kursów, a także wszelkich innych rodzajów obiektów edukacyjnych, a nawet linków zewnętrznych. Ścieżki nauki udostępniamy za pośrednictwem API i pokazujemy wszystkie zawarte w nich pozycje.

Dokumentacja: Dokumentacja interfejsów Udemy Business API – API typu RESTful

Logowanie jednokrotne (SSO)

Udemy Business może łączyć się ze wszystkimi usługami pojedynczego logowania SAML 2.0. Obejmuje to większość usługodawców SSO. Dodatkowo dostępne są spersonalizowane integracje SSO, o ile spełniają one wymogi standardu SAML 2.0.

Protokół: SAML 2.0+

Dokumentacja: Ogólne omówienie SSO i głównych funkcji Udemy Business

API do świadczenia użytkownikom usług SCIM – System do świadczenia usług do zarządzania tożsamością w wielu domenach (SCIM) umożliwia zarówno udzielanie, jak i wycofywanie licencji użytkowników. System ten pozwala twoim zespołom informatycznym lub spersonalizowanym integracjom na automatyzację funkcji zarządzania licencjami.

Protokół: SCIM

Dokumentacja: ​​System świadczenia usług do zarządzania tożsamością w wielu domenach (SCIM)

Starsze API kursów 

API kursów – Protokół: RESTful 

  • API kursów spełnia tradycyjne normy EdTech. Pozwala uzyskiwać wszystkie metadane pojedynczego kursu albo wielu kursów.

Uwaga: To nasz starszy API kursów, dla którego nie będziemy udostępniać nowych funkcji.  Wszystkie nowe funkcje będą udostępniane w naszych API GraphQL, które zawierają nie tylko kursy, ale także wszystkie obiekty edukacyjne.

Dokumentacja: Dokumentacja interfejsów Udemy Business API – API typu RESTful

Rekomendowana, najlepsza w swojej klasie integracja

Wiemy, że każdy klient i partner Udemy jest inny i może mieć indywidualne potrzeby. Aby zapewnić najlepszą w swojej klasie integrację, zalecamy korzystanie z następujących API:

1. Kursy i obiekty edukacyjne: Korzystaj z API GraphQL, aby uzyskać dostęp do wszystkich obiektów edukacyjnych

2. Raportowanie: Korzystaj z API typu REST, aby uzyskać pełny zakres danych, dodatkowo korzystając z xAPI pozwalającego uzyskiwać dane w czasie rzeczywistym

3. SSO: Z tej funkcji powinno się korzystać w połączeniu ze SCIM, aby zautomatyzować zarówno udzielanie, jak i wycofywanie licencji użytkowników

4. Ścieżki nauki: Korzystaj z API do ścieżek nauki, aby umożliwić administratorom L&D oraz liderom programów tworzenie ścieżek nauki dla użytkownika końcowego.

Powiązane artykuły

Kontakt