mam token i chce sprobowac metody z api
- User
mam token i chce sprobowac metody z api
- Assistant
Poniżej znajdziesz przykładowe kroki oraz kod do wykorzystania w Excelu (Power Query), aby pobierać dane z Jiry przy użyciu tokena.
1. Skonfiguruj zapytanie Power Query
- Otwórz nowy skoroszyt w Excelu.
- Przejdź do zakładki Dane > Pobierz dane > Z innych źródeł > Z sieci Web.
- W otwartym oknie wybierz Opcja Zaawansowane.
2. Ustaw adres URL zapytania
Przyjmijmy, że chcesz pobrać wyniki filtra. Na przykład, jeśli chcesz użyć zapytania JQL:
project = PROJ AND status = "To Do"lub użyć zapisanego filtra z numerem 12345, możesz zbudować URL w formacie:
- Dla JQL:
https://twoja-domena/jira/rest/api/2/search?jql=project=PROJ+AND+status=%22To%20Do%22&maxResults=1000 - Dla zapisanego filtra:
https://twoja-domena/jira/rest/api/2/search?filter=12345&maxResults=1000
Pamiętaj zastąpić
twoja-domenaodpowiednią domeną Twojej instancji Jiry.
3. Zastosowanie tokena automatycznie przez Power Query
Ponieważ korzystasz z tokena, będziesz musiał dodać nagłówek autoryzacyjny („Authorization”) do zapytania. Niestety, domyślny kreator „Z sieci Web” nie zawsze pozwala na ustawienie niestandardowych nagłówków – dlatego przejdziemy do Edytora zaawansowanego.
- Po pobraniu danych z sieci Web (na początek możesz wpisać choćby adres URL, by uruchomić edytor zapytań), przejdź do Edytora zaawansowanego w Power Query.
- Wklej poniższy kod, dopasowując wartości:
let // Adres URL do zapytania API url = "https://twoja-domena/jira/rest/api/2/search?filter=12345&maxResults=1000", // Wysłanie zapytania z tokenem autoryzacyjnym Source = Json.Document(Web.Contents(url, [ Headers = [ Authorization = "Bearer TWÓJ_TOKEN" ] ])), // Jeśli potrzebujesz rozwinąć wynik (np. lista issue), możesz dopisać przekształcenia, np.: issues = Source[issues], // Konwersja listy do tabeli issuesTable = Table.FromList(issues, Splitter.SplitByNothing(), null, null, ExtraValues.Error) in issuesTableWażne:
- Zamień
twoja-domenana Twoją domenę (np.jira.mojadomena.pl). - Zamień
12345na numer Twojego zapisanego filtra lub dostosuj JQL w URL. - Zamień
TWÓJ_TOKENna swój token.
4. Dalsze przekształcenia
- Po pobraniu danych w formacie JSON możesz rozwijać kolumnę, aby wyodrębnić interesujące Cię pola, np.
key,summary,statusitp. - W Power Query kliknij w ikonę rozwijania kolumny (strzałka w kolumnie) i wybierz odpowiednie pola.
5. Ustaw automatyczne odświeżanie
Jeśli chcesz, aby dane były pobierane automatycznie:
- Zapisz zapytanie w Power Query.
- W Excelu przejdź do Dane > Odśwież wszystko lub ustaw harmonogram odświeżania przy użyciu mechanizmów dostępnych w Twoim systemie (np. przy otwarciu pliku).
Podsumowanie
Dzięki wykorzystaniu Power Query i funkcji
Web.Contentsmożesz łatwo pobierać dane z Jiry (self-hosted) korzystając z tokena API. W razie potrzeby możesz dopasować kod do własnych wymagań, rozbudowując go o dodatkowe przekształcenia, filtrowanie czy obsługę błędów.Powodzenia! Jeśli masz dodatkowe pytania lub potrzebujesz pomocy w trakcie implementacji, daj znać.
- User
po wpisaniu url mam komunikat "Nie możemy wykonać uwierzytelnienia przy użyciu podanych poświadczeń. Spróbuj ponownie"
- Assistant
Taki błąd może wystąpić, gdy:
- Excel próbuje użyć swoich domyślnych poświadczeń, a nie tych, które przekazujesz przez nagłówek.
- Token jest niepoprawny lub nie jest przekazywany w odpowiednim formacie.
Oto kilka kroków, które warto sprawdzić i zastosować:
1. Weryfikacja formatu tokena
- Upewnij się, że token jest poprawny oraz że umieszczasz go w nagłówku dokładnie w taki sposób:
- Jeśli używasz mechanizmu Bearer, nagłówek powinien wyglądać tak:
Authorization: Bearer TWÓJ_TOKEN - Sprawdź, czy nie ma zbędnych spacji lub błędów w zapisie tokena.
- Jeśli używasz mechanizmu Bearer, nagłówek powinien wyglądać tak:
2. Ustawienia zapytania w Power Query
Aby Excel nie próbował nadpisywać nagłówka autoryzacji domyślnymi poświadczeniami, zastosuj następujące kroki:
-
Edytor zaawansowany Power Query
Upewnij się, że korzystasz z edytora zaawansowanego, w którym wpisujesz własny kod. Przykładowy kod:let // Adres URL zapytania url = "https://twoja-domena/jira/rest/api/2/search?filter=12345&maxResults=1000", // Wysłanie zapytania z tokenem Source = Json.Document(Web.Contents(url, [ Headers = [ Authorization = "Bearer TWÓJ_TOKEN" ], // Ustawienie trybu anonimowego, aby Excel nie używał własnych poświadczeń ManualStatusHandling = {401} ])) in Source -
Ustawienie poziomu uwierzytelniania
- Przejdź do:
Plik > Opcje > Zapytania i Połączenia > Źródła danych > Ustawienia źródeł danych... - Znajdź źródło danych odpowiadające Twojemu zapytaniu (może to być adres Twojej domeny).
- Kliknij Edytuj uprawnienia i ustaw typ uwierzytelnienia na Anonimowy lub Brak. Dzięki temu Excel nie dołączy dodatkowych poświadczeń, które mogłyby kolidować z Twoim nagłówkiem.
- Przejdź do:
3. Sprawdzenie logiki zapytania
- Upewnij się, że adres URL jest poprawny, a Twoja instancja Jiry akceptuje zapytania przez API z tokenem.
- Jeśli korzystasz z zapytania z zapisanym filtrem, upewnij się, że numer filtra oraz parametr
maxResultssą zgodne z dokumentacją Jiry.
4. Testowanie poza Excelem
-
Możesz przetestować zapytanie w narzędziu takim jak Postman lub cURL, aby upewnić się, że token działa poprawnie. Przykład z cURL:
curl -X GET \ -H "Authorization: Bearer TWÓJ_TOKEN" \ "https://twoja-domena/jira/rest/api/2/search?filter=12345&maxResults=1000"Jeśli odpowiedź będzie poprawna (bez błędu 401), problem leży po stronie ustawień Power Query.
5. Dodatkowe wskazówki
- Pamiętaj: Po aktualizacji ustawień źródła danych w Excelu możesz potrzebować usunąć istniejące zapisane poświadczenia (w Menu Źródła danych), aby zmiany zaczęły obowiązywać.
- Debugowanie: Jeśli nadal napotykasz błąd 401, możesz dodać opcję
ManualStatusHandling = {401}i w kodzie sprawdzić wynik, aby lepiej zdiagnozować problem.
Stosując powyższe kroki, powinieneś uniknąć sytuacji, w której Excel automatycznie dodaje niewłaściwe poświadczenia i zapytanie przebiegnie z podanym tokenem. Jeśli będą jeszcze problemy lub pytania, daj znać!
- User
co mam wpisać w parametrach nagłowka ?
- Assistant
W przypadku korzystania z tokena API najczęściej musisz ustawić nagłówek
Authorizationz wartością typuBearer <TWÓJ_TOKEN>. Dodatkowo, możesz (ale nie zawsze musisz) dodać nagłówekAccept: application/json, aby poinformować serwer, że oczekujesz odpowiedzi w formacie JSON.Przykładowo, w Power Query kod mógłby wyglądać tak:
let url = "https://twoja-domena/jira/rest/api/2/search?filter=12345&maxResults=1000", Source = Json.Document(Web.Contents(url, [ Headers = [ Authorization = "Bearer TWÓJ_TOKEN", Accept = "application/json" ] ])) in SourceCo wpisać:
-
Authorization:
Bearer TWÓJ_TOKEN
(ZastąpTWÓJ_TOKENswoim rzeczywistym tokenem API. Pamiętaj, aby nie dodawać dodatkowych spacji albo znaków.) -
Accept:
application/json
(Opcjonalne, ale zalecane, aby serwer wiedział, że chcesz otrzymać dane w formacie JSON.)
Ważne:
- Upewnij się, że adres URL jest poprawny i że Twoja instancja Jiry (self-hosted) obsługuje takie zapytania.
- Jeśli spotykasz błędy autoryzacji, warto przetestować zapytanie np. przy pomocy Postmana lub cURL, aby upewnić się, że token działa poprawnie.
- W ustawieniach źródła danych w Excelu sprawdź też, czy nie są używane dodatkowe poświadczenia, które mogą kolidować z Twoim nagłówkiem (np. ustawienie uwierzytelniania na "Anonimowy").
Powodzenia! Jeśli pojawią się dodatkowe pytania lub problemy, pisz śmiało.
-
- User
czy token to ten wygenerowany w "Personal Access Tokens" w jirze?
- Assistant
Tak, jeśli w Twojej instancji Jiry (self-hosted) wykorzystujesz mechanizm Personal Access Tokens, to właśnie ten token należy użyć do autoryzacji. Wówczas w nagłówku zapytania do API zapisujesz go w następujący sposób:
- Authorization:
Bearer TWÓJ_TOKEN
(gdzieTWÓJ_TOKENto wygenerowany token z sekcji "Personal Access Tokens")
Pamiętaj również, aby upewnić się, że instancja Jiry jest skonfigurowana do akceptowania tego typu tokenów oraz że Twoje zapytanie trafia pod właściwy adres API. Jeśli wystąpią problemy, warto sprawdzić dokumentację Jiry lub skontaktować się z administratorem instancji.
- Authorization:
- User
muszę użyc postmana lub innego narzędzia do odpytywania edpoint'u czy moge pobrac dane bezpośrednio w excelu?
- Assistant
Tak, nie musisz używać Postmana ani innego narzędzia – możesz bezpośrednio pobierać dane w Excelu przy użyciu Power Query. Wystarczy, że skonfigurujesz zapytanie z odpowiednimi nagłówkami (np.
Authorization: Bearer TWÓJ_TOKEN) oraz ustawisz poprawny URL endpointu Jiry.Kroki, jak to zrobić w Excelu:
-
Uruchom Power Query:
- W Excelu przejdź do Dane → Pobierz dane → Z innych źródeł → Z sieci Web.
-
Wprowadź URL:
- Wklej URL odpowiadający Twojemu zapytaniu do API, np.:
https://twoja-domena/jira/rest/api/2/search?filter=12345&maxResults=1000 - Jeśli używasz zapytania z JQL, upewnij się, że parametr JQL jest poprawnie zakodowany.
- Wklej URL odpowiadający Twojemu zapytaniu do API, np.:
-
Edytuj zapytanie w edytorze zaawansowanym:
-
Po podstawowym pobraniu danych kliknij Edytor zaawansowany i dopasuj kod do poniższego przykładu:
let url = "https://twoja-domena/jira/rest/api/2/search?filter=12345&maxResults=1000", Source = Json.Document(Web.Contents(url, [ Headers = [ Authorization = "Bearer TWÓJ_TOKEN", Accept = "application/json" ] ])) in Source
-
-
Ustawienia uwierzytelniania:
- Upewnij się, że w ustawieniach źródła danych w Excelu (Plik → Opcje → Zapytania i Połączenia → Źródła danych) usuniesz zapisane poświadczenia lub ustawisz poziom autentykacji na anonimowy, aby Excel nie dodawał swoich domyślnych poświadczeń, które mogłyby kolidować z tokenem.
-
Przetwarzanie danych JSON:
- Po poprawnym pobraniu danych możesz rozwinąć kolumny (np. wynikowe pole
issues) i przekształcić dane do formatu tabelarycznego.
- Po poprawnym pobraniu danych możesz rozwinąć kolumny (np. wynikowe pole
Dzięki powyższym krokom pobierasz dane bezpośrednio w Excelu, korzystając z Twojego tokena API. Jeśli wszystko jest skonfigurowane prawidłowo, dane powinny się załadować, a następnie możesz ustawić automatyczne odświeżanie, aby dane aktualizowały się przy każdym otwarciu pliku lub zgodnie z określonym harmonogramem.
W razie problemów lub pytań – daj znać!
-
- User
czy znajde postmana lub inna aplikację w microsoft store?
- Assistant
Tak, Postman jest dostępny w Microsoft Store, więc możesz go tam znaleźć i zainstalować. Alternatywnie, możesz pobrać go również bezpośrednio ze strony oficjalnej Postmana.
Jeśli chciałbyś przetestować API czy inne rozwiązania, w Microsoft Store znajdziesz także inne narzędzia, na przykład:
- Insomnia – nowoczesny klient REST, choć warto sprawdzić jego dostępność w Microsoft Store lub pobrać bezpośrednio ze strony Insomnia.
- Thunder Client for VS Code – jeśli korzystasz z Visual Studio Code, istnieje rozszerzenie, które umożliwia testowanie API bez konieczności instalowania oddzielnej aplikacji.
W skrócie, możesz pobrać Postmana z Microsoft Store lub ze strony producenta, w zależności od preferencji.
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.