PRO REST API
Za pomocą Produkcja REST API można:
• Formułować zapytania o cenę sparametryzowanego artykułu.
• Tworzyć zamówienia z listą sparametryzowanych artykułów.
• Formułować zapytania o status utworzonego asynchronicznie zamówienia.
Wszystkie zapytania asynchroniczne są umieszczane w kolejce przez System Produkcja i wykonywane zgodnie z tą kolejką.
Aby sprawdzić status wysyłanych zapytań oraz wielkość kolejki, należy przejść na stronę: https://{Adres_serwera_IIS:Port}/hangfire (strona jest dostępna wyłącznie lokalnie na serwerze, na którym zainstalowano Bramkę IIS).
Autoryzacja:
Wszystkie zapytania do serwera wymagają podania prawidłowego i ważnego tokenu dostępu („access token”).
Aby pobrać token dostępu („access token”), należy posiadać klucz aplikacji (nazwę użytkownika (username) oraz hasło (password)) i podać je w postaci ciągu Base64 w nagłówku autoryzacji jako BASIC AUTH.
Username: Production.Extensions
Password: Należy zdefiniować w pliku konfiguracyjnym Configuration.config (znajdującym się w folderze instalacyjnym Bramki IIS), w węźle ExtensionsPath. Uwaga! Po dodaniu hasła należy ponownie uruchomić witrynę IIS.
Nagłówek „Authorization”: BASIC {login:hasło (w formie BASE64)}
POST https://{Adres_serwera_IIS:Port}/auth
Przykładowe zapytanie:
curl --location 'https://localhost:44010/ProGate/auth' \
--header 'Content-Type: application/x-www-form-urlencoded' \-
--header 'Authorization: Basic bG9naW46aGFzbG8=' \
--data-urlencode 'grant_type=client_credentials'
Przykładowa odpowiedź:
{ "access_token": "ofB4H57cTx6-nWM_0CPW1OY5VZ4VbOf1zJm4MqI9dXNCQCKNJ3aBHbtb0lH6N-7BKDFBSEiAZJL9Qx3e_GaVjzU9Y3qnMi5tPf0KzMif3Ez3PYow_RJxm4gPonBpISouf34lWS2XAbP8X6F_w-C7zv8qRDOfCFGq18oM3be0ZcPHD_anJoD8EFeY8qdlqQfcdA6JWV5UBjarZVM1ube2sFFNAV7hiQ6aJ6slB0vvULXFttCf_suSd2q3Sfm6lU1jF2FIiNnlCyIwmNd6fpr9_ckol2vdjJUafFfcsIC1qm4",
"token_type": "bearer",
"expires_in": 3599,
".issued": "Thu, 25 Jan 2024 11:34:21 GMT",
".expires": "Thu, 25 Jan 2024 12:34:21 GMT"}
Przykładowy błąd:
{"error": "Client password authorization denied.",
"error_description": "Odmowa autoryzacji aplikacji!\r\nBłędny klucz aplikacji."}
Otrzymany token dostępu („access token”) należy umieścić w zapytaniach w nagłówku „Authorization” jako token okaziciela (Bearer token).