Merge remote-tracking branch 'origin/release' into release

Author: rskrzypczak

i18n/en/docusaurus-plugin-content-docs/current/3-administrator-guides/15-integration/02-mailbox/gmail-10.jpg

@@ -1,6 +1,6 @@
 ---
 title: Configuration
-description: Jak prawidłowo skonfigurować API w YetiForce
+description: How to properly configure API in YetiForce
 keywords:
   - Webservice
   - API
@@ -16,90 +16,90 @@ preview: configuration-1.jpg
 
 ## Configuration
 
-W celu skonfigurowania połączenie API, należy najpierw wygenerować klucz API oraz utworzyć użytkownika do autoryzacji.
+To configure an API connection, you must first generate an API key and create a user for authorization.
 
-### Generowanie API Key
+### Generate API Key
 
-Pierwszym krokiem w celu podłączenia się do API, jest wygenerowanie `API Key`. W tym celu, w sekcji administracyjnej należy wybrać w lewym menu `Integracja` a następnie `Web service - Alikacje`.
+The first step to connect to the API is to generate an `API Key`. To do this, in the administration section, select `Integration` in the left menu and then `Web service - Applications`.
 
 ![step 1](configuration-1.jpg)
 
-W celu dodania nowego API Key, wybieramy `Dodaj klucz` z prawej górnej strony.
+To add a new API Key, select `Add Key` from the top right.
 
 ![step 2](configuration-2.jpg)
 
-Pojawi nam się okno dodawania nowego API Key:
+A popup window will appear where you can add a new API Key:
 
 ![step 3](configuration-3.jpg)
 
-#### Nazwa
+#### Name
 
-- dowolna nazwa, pozwlająca nam zidentyfikować dodany API Key
+- any name that allows us to identify the added API Key
 
-#### Hasło
+#### Password
 
-- ciąg znaków wykorzystywany do uwierzytelniania
+- string of characters used for authentication
 
 #### Status
 
-- odznaczenie checkboxa, spowoduje, że API Key nie będzie aktywne
+- leaving this checkbox unticked will cause the API to be inactive
 
-#### Typ
+#### Type
 
-- określa jakich funkcjonalności będzie dotyczył API Key
+- determines what functionalities the API Key will cover
 
-#### Dozwolone adresy IP
+#### Allowed IPs
 
-- Pusta wartość - dostęp ze wszystkich serwerów.
-  Jeśli adresy IP zostaną wprowadzone (po przecinku), to dostęp do API będzie dozwolony tylko z tych adresów IP.
-  Przykład: x.x.x.x , y.y.y.y
+- Empty value - access from all servers.
+  If IP addresses are entered (after a comma), then API access will be allowed only from these IP addresses.
+  Example: x.x.x.x , y.y.y.y
 
-#### Publiczny adres URL
+#### Public URL address
 
-- Adres URL będzie używany do wysyłania powiadomień mailowych gdzie w treści będzie można używać adresu URL np. reset hasła w Portalu Klienta, link do podglądu rekordu w Portalu Klienta
+- The URL will be used to send email notifications where the URL address can be used in the content, e.g., password reset in the Customer Portal, link to view the record in the Customer Portal
 
-### Utworzenie użytkownika
+### Create user
 
-Kolejnym krokiem jest utworzenie danych walidacyjnych do API. W tym celu w sekcji administracyjnej z lewym menu wybieramy `Integracja ➞ Web service - Użytkownicy`.
+The next step is to create validation data for the API. To do this, in the administration section from the left menu, select `Integration ➞ Web service - Users`.
 
 ![step 4](configuration-4.jpg)
 
-Użytkownika będziemy dodawać dla konkretnego rodzaju usługi, dlatego w pierwszej kolejności wybieramy odpowiednią zakładkę.
+The user will be added for a specific type of service, so first select the relevant tab.
 
 ![step 5](configuration-5.jpg)
 
-W celu dodania nowego użytkownika, wybieramy przycisk <kbd>Dodaj rekord</kbd>. Pojawi się nam wówczas okno modalne, w którym będziemy mogli skonfigurować dostępy.
+To add a new user, select the <kbd>Add record</kbd> button. A popup window will then appear, where you can configure credentials.
 
 ![step 6](configuration-6.jpg)
 
 ![step 7](configuration-7.jpg)
 
-#### Serwer
+#### Server
 
-- wybieramy, API Key, który będzie powiązany z tworzonym użytkownikiem
+- choose the API Key that will be associated with the new user
 
 #### Status
 
-- określamy, czy dany użytkownik jest aktywny
+- defines if the user is active
 
-#### Hasło
+#### Password
 
-- ciąg znaków wykorzystywany do autoryzacji
+- string of characters used for authentication
 
-#### Typ
+#### Type
 
-- podstawa uprawień do rekordów
+- basis for record permissions
 
-#### Kontakt
+#### Contact
 
-- opcjonalny w zależności od wybranego `Typu` uprawień do rekordów
+- optional depending on the selected `Type` of record permissions
 
-#### Profil uprawnień
+#### Permission profile
 
-- użytkownik, na którym bazują uprawnienia do akcji i danych
+- permissions for actions and data are based on the selected user
 
-#### Metoda uwierzytelniania i Metoda uwierzytelniania 2FA
+#### Authentication Method and 2FA Authentication Method
 
-- określa szczegóły odnośnie uwierzytelniania użytkownika
+- specifies the details for user authentication
 
-Po utworzeniu API Key i użytkownika, możemy przystąpić do nawiązania połączenia przez API. Jak to zrobić zostało opisane w tym artykule: [Pierwsze połączenie API](/developer-guides/api/first-connect)
+After creating the API Key and user, you can start connecting via API. How to do that is described in this article: [First API Connection](/developer-guides/api/first-connect)

i18n/en/docusaurus-plugin-content-docs/current/4-developer-guides/2-api/0-config.md

@@ -1,6 +1,6 @@
 ---
-title: Pierwsze Połączenie
-description: Jak rozpocząć pierwsze połączenie
+title: First connection
+description: How to establish the first connection
 keywords:
   - Webservice
   - API
@@ -15,39 +15,39 @@ tags:
 preview: request-3.jpg
 ---
 
-Posiadając już prawidłowo skonfigurowany klucz API i dane uwierzytelniające (zgodnie z instrukcją [konfiguracji](/developer-guides/api/config)), możemy nawiązać połączenie. By pobrać dane z serwera, należy najpierw uzyskać token uwierzytelniający. Poniższa instrukcja wyjaśnia, jak to zrobić.
+Once you have the API key and credentials properly configured (according to the [configuration](/developer-guides/api/config) instructions), you can establish a connection. To retrieve data from the server, you must first obtain an authentication token. The instructions below explain how to do this.
 
-## Uzyskiwanie Tokenu uwierzytelniającego
+## Obtain an Authentication Token
 
-W celu uzyskania tokenu, wysyłamy do naszego serwera żądanie pod adres:
+To obtain a token, send a request to your server at the following address:
 
 ![request 1](request-1.jpg)
 
-Do testowania tego procesu można użyć programu `Postman`. Na kolejnych zrzutach ekranu będzie przedstawione krok po kroku, jak to zrobić.
+You can use `Postman` to test this process. The following screenshots will guide you step by step how to do it.
 
-W pierwszej kolejności będzie potrzebna wartość `API Key`. By ją pobrać, w sekcji administracyjnej wybierz z lewego menu `Integracja ➞ Web service - aplikacje` a następnie przy interesującym cię kluczu naciśnij przycisk <kbd><i class="fa-solid fa-copy"></i></kbd> by skopiować jego wartość.
+First, you will need the `API Key` value. To download it, in the administration section, select `Integration ➞ Web service - applications` from the left menu, select the relevant key, and click the <kbd><i class="fa-solid fa-copy"></i></kbd> button to copy its value.
 
 ![api_key](api_key.jpg)
 
-W programie `Postman` dodajemy nagłówek `X-API-KEY`. Zamiast wartości `{{APi-KEY}}` wpisujemy wartość API Key skopiowaną z systemu YetiForce.
+In `Postman` add the `X-API-KEY` header. Instead of the `{{APi-KEY}}` value enter the API Key value copied from the YetiForce system.
 
 ![request 2](request-2.jpg)
 
-Następnie podajemy dane do logowania, zgodnie z poniższym zrzutem ekranu. Zamiast zmiennej `{{URL}}` podajemy adres naszej platformy YetiForce. Dane uwierzytelniające `userName` i `password` wpisujemy zgodnie z wartościami ustalonymi w sekcji administracyjnej w zakładce `Integracja ➞ Web service - użytkownicy`.
+Then enter the credentials, according to the screenshot below. Instead of the `{{URL}}` variable, provide the address of your YetiForce platform. Enter the `userName` and `password` credentials according to the values ​​set in the administration section in the `Integration ➞ Web service - users` tab.
 
-W informacji zwrotnej otrzymamy parametr `token`, który będziemy przekazywać w kolejnych requestach.
+You will receive the `token` parameter as feedback, which you will pass in subsequent requests.
 
 ![request 3](request-3.jpg)
 
-## Kolejne requesty
+## Next requests
 
-Po uzyskaniu wartości `token`, możemy przejść do odpytywania API o interesujące nas dane. W tym celu do kolejnych requestów dodajemy nagłówek `x-token` z wartością uzyskanego tokena.
+Once you get the `token` value, you can proceed to query the API for the relevant data. To do this, add the `x-token` header with the value of the obtained token to subsequent requests.
 
 ![request 4](request-4.jpg)
 
-W zależności od tego, czy mamy wykupioną usługę `WebService Premium` czy też korzystamy z `WebService Standard`, będziemy mieć do dyspozycji inny zakres dostępnych endpointów.
+Depending on whether you have purchased the `WebService Premium` service or use `WebService Standard`, you will have a different range of available endpoints at your disposal.
 
-### Lista Endpointów dla poszczególnych usług
+### List of Endpoints for services
 
 - [Webservice Standard](/developer-guides/api/WebserviceStandard)
 - [Webservice Premium](/developer-guides/api/WebservicePremium)