Microsoft Graph API to ujednolicone REST API zapewniające dostęp do danych i funkcji całego ekosystemu Microsoft 365 – poczty Exchange, kalendarzy, kontaktów Outlook, plików SharePoint i OneDrive, wiadomości Teams, użytkowników Entra ID, wydarzeń kalendarza i wielu innych. Deweloperzy budujący integracje z Microsoft 365 używają Graph API zamiast osobnych API dla każdej usługi, uzyskując dostęp do wszystkich danych przez jeden endpoint (graph.microsoft.com) z jedną metodą uwierzytelniania OAuth 2.0. Integracja systemów ERP, CRM i własnych aplikacji z danymi Microsoft 365 przez Graph API jest standardem nowoczesnych wdrożeń B2B.
Jeden endpoint dla całego Microsoft 365
Przed Graph API każda usługa Microsoft miała własne API z odmienną strukturą i uwierzytelnianiem – Exchange Web Services (EWS) dla poczty, SharePoint REST API dla dokumentów, różne inne endpointy dla Teams i Entra ID. Graph API unifikuje dostęp przez jeden endpoint v1.0 (stabilny) lub beta (nowe funkcje) z tokenem dostępu Azure AD. Deweloper implementuje raz mechanizm uwierzytelniania OAuth 2.0 z zakresami uprawnień (scopes) i używa tego samego tokenu do odczytu poczty, tworzenia zadań Planner i pobierania plików SharePoint – bez oddzielnych konektorów dla każdej usługi.
Uprawnienia i model bezpieczeństwa
Graph API używa dwóch typów uprawnień: Delegated (w imieniu zalogowanego użytkownika, ograniczone do jego danych) i Application (działanie jako aplikacja bez zalogowanego użytkownika, dostęp do danych organizacji). Application permissions wymagają zgody administratora globalnego – np. uprawnienie Mail.ReadWrite.All pozwala aplikacji czytać i pisać pocztę wszystkich użytkowników, co wymaga starannej oceny bezpieczeństwa. Zasada least privilege jest kluczowa – aplikacja powinna żądać tylko uprawnień, których faktycznie potrzebuje do działania.
Typowe scenariusze integracji
System ERP integruje się z Exchange Online przez Graph API do automatycznego wysyłania faktur e-mailem i pobierania potwierdzenia odczytania. Aplikacja CRM synchronizuje kontakty z listą kontaktów Outlook użytkownika bez ręcznego eksportu/importu. Bot Teams obsługi klienta tworzy zadania Planner i wysyła wiadomości na kanał Teams przy nowym zgłoszeniu przez Graph API. Automatyzacja HR onboardingu tworzy konto Entra ID, przydziela grupy, SharePoint i Teams przez Graph API zamiast przez interfejs Admin Center. Każdy z tych scenariuszy zastępuje ręczną, powtarzalną pracę administratorów.
Webhooks i Change Notifications
Graph API obsługuje webhooks (Change Notifications) – subskrypcja powiadomień o zmianach w zasobach Microsoft 365 bez ciągłego odpytywania (polling). Aplikacja subskrybuje powiadomienia o nowych wiadomościach e-mail, zdarzeniach kalendarza lub zmianach plików SharePoint i otrzymuje notyfikację HTTP przy każdej zmianie. To efektywniejsze niż polling API co kilka sekund i pozwala budować aplikacje reagujące na zdarzenia w Microsoft 365 w czasie zbliżonym do rzeczywistego bez obciążenia API żądaniami cyklicznymi.
Microsoft Graph SDK i narzędzia deweloperskie
Microsoft udostępnia SDK do Graph API dla .NET, JavaScript/TypeScript, Python, Java, Go i PHP z obsługą uwierzytelniania, paginacji i retry logic. Graph Explorer (developer.microsoft.com/graph/graph-explorer) pozwala interaktywnie eksplorować API i testować zapytania w przeglądarce bez pisania kodu. Postman Collection dla Microsoft Graph umożliwia testowanie API przez popularny klient REST. Microsoft Graph PowerShell SDK zastępuje stare moduły Az.Accounts, MSOnline i AzureAD dla administratorów zarządzających Microsoft 365 przez skrypty PowerShell.
