Ten artykuł wyjaśni, jak skonfigurować identyfikatory API w FM.
Korzystanie z tożsamości API umożliwia szczegółowy dostęp do Dalux FM API, z wykorzystaniem istniejących stanowisk użytkowników i logiki regionów. Pozwala to na ograniczenie dostępu API tylko do niezbędnych danych.
Czytaj więcej
Jeśli chcesz dowiedzieć się więcej o interfejsach API Dalux, przeczytaj ten artykuł: Dalux API.
Jak skonfigurować identyfikatory API
Informacje techniczne
Tożsamości API mogą być używane do dostępu do Dalux FM API od wersji 2.0.0 i nowszych.
Tożsamości API mogą być tworzone i zarządzane tylko przez administratorów w instancji FM.
Tożsamość API nie może używać adresu e-mail już powiązanego z zarejestrowanym lub zaproszonym użytkownikiem w Dalux FM. Podobnie, adres e-mail dla tożsamości API nie może być użyty dla użytkownika Dalux FM.
Aby utworzyć tożsamość API, przejdź do:
Ustawienia
Integracje
'Tożsamości API':
Aby utworzyć nową tożsamość API, kliknij Dodaj.
-
Typ tożsamości - Masz dwie opcje
- Ogólne - Bezpośredni dostęp do danych w instancji FM
- Firma - Dostęp zewnętrznego dostawcy do danych, zgodnie z konfiguracją ustawień firmy
- Nazwa - Nazwa tożsamości API (może być zmieniona później)
- Email - Email używany do komunikacji w zakresie usług Dalux API i wykorzystania tożsamości API (nie może być zmieniony po utworzeniu tożsamości API)
- Administrator - Nadpisuje uprawnienia dowolnej roli użytkownika i umożliwia dostęp do wszystkich danych. Dla typu tożsamości „Firma” zapewnia dostęp administratora firmy.
- Opis - Opcjonalny opis tożsamości API, który pomoże Tobie i innym w przyszłości
Po wypełnieniu wymaganych informacji, przeczytaniu i zaakceptowaniu regulaminu, kliknij 'Utwórz', aby kontynuować konfigurację tożsamości API.
Uwaga
Klucze API nie są generowane, dopóki nie dodasz ich do tożsamości API w dalszym procesie.
Teraz możesz przypisać role użytkowników i regiony do tożsamości API. Określają one, które dane są dostępne przez API. Na przykład, nie masz dostępu do danych zleceń pracy, jeśli przypisane role użytkowników nie mają do nich dostępu.
Jeśli tożsamość API ma uprawnienia administratora, nadpisuje wszelkie uprawnienia w rolach użytkowników i umożliwia dostęp do wszystkich danych.
Aby dodać role użytkowników i regiony do tożsamości API, kliknij 'Dodaj' w obszarze ról użytkowników.
Możesz dodać role użytkowników samodzielnie lub także określić region dla roli użytkownika.
Po dodaniu swoich ról użytkowników, możesz rozpocząć tworzenie kluczy API. Aby utworzyć klucze API dla tożsamości API, kliknij 'Dodaj' w obszarze kluczy API. Podczas tworzenia klucza API musisz określić czas wygaśnięcia klucza.
Po kliknięciu 'Dodaj', klucz API zostanie wygenerowany.
Skopiuj klucz i rozpowszechniaj go zgodnie z warunkami i zasadami. Tożsamość API może teraz używać swojego klucza API, ograniczonego do interfejsu API określonego przez dostęp wynikający z roli użytkownika.
Czytaj więcej
Jeśli chcesz dowiedzieć się więcej o interfejsach API Dalux, przeczytaj ten artykuł: Dalux API.