allegro / allegro/allegro-api

[NEWS] Nowa wersja Developer Apps - analityka Twojej aplikacji / New Developer Apps version - analytics for your application

未关闭
#13,683 0 条评论 0 个 reaction 已指派 1 人 已被 @Aureliusz-Brussy 认领 在 GitHub 查看
Dev Apps News
主要语言
没有语言数据
星标
244
派生
40
PR 合并指标
30 天内没有已合并 PR

描述

Przedstawiamy nową wersję panelu **Developer Apps 2.0**, w której wdrażamy dedykowany moduł analityczny. Naszym celem jest zebranie kluczowych danych o integracji z publicznym API Allegro w jednym miejscu \- tak, aby ułatwić Ci monitorowanie kondycji aplikacji oraz dbanie o zgodność z wymaganiami technicznymi platformy.

Adres URL panelu pozostaje bez zmian: [**apps.developer.allegro.pl**](https://apps.developer.allegro.pl).

Poniżej znajdziesz zestawienie najważniejszych zmian i nowych narzędzi, które ułatwią Ci codzienną pracę oraz debugowanie aplikacji.

**Zgodność z wymogami**

![Black leather crossbody bag, smooth texture, adjustable strap.](https://a.allegroimg.com/s1200/124400/41065c4d4ff69396140f0fcc8b11 'Black leather crossbody bag, smooth texture, adjustable strap.')

Sekcja ta pozwala szybko zweryfikować, czy Twoje oprogramowanie spełnia wymagania wynikające z naszych wytycznych.

Aktualnie możesz zweryfikować **poprawność nagłówka User-Agent.** [Stosowanie poprawnego nagłówka jest obowiązkowe dla wszystkich aplikacji](https://developer.allegro.pl/news/do-konca-czerwca-2026-zaimplementuj-wlasny-niestandardowy-identyfikator-user-agent-w-twojej-aplikacji-q0K2EbxgXCg). Status *Niezgodny* oznacza, że poprzedniego dnia system odnotował niepoprawny nagłówek lub jego brak w co najmniej jednym zapytaniu do API Allegro.

Jeśli chcesz sprawdzić poprawność konstrukcji swojego nagłówka lub wygenerować nowy, możesz skorzystać [z dedykowanego narzędzia](https://apps.developer.allegro.pl/user-agent).

**Monitorowanie ruchu**

![API Query Chart, blue line graph, data visualization, shows traffic trends](https://a.allegroimg.com/s1200/122585/134f38e0452e8c7d0df0bfb7de76 'API Query Chart, blue line graph, data visualization, shows traffic trends')

W module **Zapytania do API** znajdziesz wykres przedstawiający dzienną liczbę żądań kierowanych przez Twoją aplikację do publicznego API Allegro. Narzędzie ułatwia śledzenie trendów w wolumenie ruchu oraz proaktywne kontrolowanie limitów.

**Analityka błędów**

![Error chart, grey background, technical and business errors, data visualization.](https://a.allegroimg.com/s1200/1288b3/79219bab4fafb172250fa4171b75 'Error chart, grey background, technical and business errors, data visualization.')

W sekcji **Błędy** sprawdzisz, jaki odsetek błędów generują Twoje zapytania. Aby ułatwić Ci diagnozowanie problemów, podzieliliśmy je na dwie kategorie:

* **Błędy techniczne:** agregują klasyczne kody odpowiedzi HTTP (np. 400, 403 itp.), pozwalając szybko namierzyć awarie komunikacyjne lub problemy z autoryzacją.

![Technical error log, black and white, text-based, lists errors.](https://a.allegroimg.com/s1200/12b1af/09a6499d496fb250f36849ed8b9c 'Technical error log, black and white, text-based, lists errors.')

* **Błędy biznesowe:** wynikają bezpośrednio z logiki procesów operacyjnych na Allegro, takich jak walidacja reguł podczas tworzenia lub edycji ofert.

![Business Error Log, White, Paper, Text-based, Error Codes](https://a.allegroimg.com/s1200/12d858/c0bfe4714530982e21f6d2027b45 'Business Error Log, White, Paper, Text-based, Error Codes')

Dodatkowo **lista błędów biznesowych** pozwala na szczegółowe śledzenie ich występowania. Każda pozycja na liście zawiera dokładny kod błędu, jasny opis dla użytkownika oraz ścieżkę (endpoint), co przyspiesza identyfikację źródła problemu.

**Plany na przyszłość i Twój feedback**

To pierwsza faza rozwoju nowego panelu. Planujemy wdrożyć kolejne metryki, które pomogą Ci monitorować swoją aplikację jeszcze dokładniej.

Chcemy rozwijać to narzędzie w oparciu o Twoje realne potrzeby i feedback. Jeśli masz pomysły na nowe wykresy lub chcesz zgłosić uwagi techniczne, możesz przesłać nam swoją opinię bezpośrednio z poziomu panelu za pomocą przycisku **„Dodaj wykres”**.

--------

We present the new version of the **Developer Apps 2.0** panel, featuring a dedicated analytics module. Our goal is to gather key data about your integration with the Allegro public API in a single location \- making it easier for you to monitor your application's health and ensure compliance with the platform's technical requirements.

The panel URL remains the same: [**apps.developer.allegro.pl**](https://apps.developer.allegro.pl).

Below you will find an overview of the most important changes and new tools designed to facilitate your daily work and application debugging.

**Compliance with requirements**

![User-agent header compliance report, black background, text-based interface.](https://a.allegroimg.com/s1200/128bff/051d2b634d09ba56b3500072061e 'User-agent header compliance report, black background, text-based interface.')

This section allows you to quickly verify whether your software meets the requirements outlined in our guidelines.

Currently, you can verify the **validity of your User-Agent header.** [Using a valid header is mandatory for all applications](https://developer.allegro.pl/news/do-konca-czerwca-2026-zaimplementuj-wlasny-niestandardowy-identyfikator-user-agent-w-twojej-aplikacji-q0K2EbxgXCg). The *Non-compliant* status means that on the previous day, the system recorded an incorrect header or its absence in at least one request to the Allegro API.

If you want to check the structure of your header or generate a new one, you can use [the dedicated tool](https://apps.developer.allegro.pl/user-agent).

**Traffic Monitoring**

![API Call Chart: Blue line graph, 2022-06-19 to 2022-07-02, API calls.](https://a.allegroimg.com/s1200/12ac3a/84272379497e8bc50e52740607ec 'API Call Chart: Blue line graph, 2022-06-19 to 2022-07-02, API calls.')

In the **API Requests** module, you will find a chart showing the daily number of requests sent by your application to the Allegro public API. This tool makes it easier to track traffic volume trends and proactively manage your limits.

**Error Analytics**

![Error chart, gray bar graph, technical errors, business errors, 2025-06-19 to 2026-07-02.](https://a.allegroimg.com/s1200/1231a6/38a217494376860ff859f0548600 'Error chart, gray bar graph, technical errors, business errors, 2025-06-19 to 2026-07-02.')

In the **Errors** section, you can check the percentage of errors generated by your requests. To make it easier for you to diagnose issues, we have divided them into two categories:

* **Technical errors:** aggregate classic HTTP response codes (e.g., 400, 403, etc.), allowing you to quickly pinpoint communication failures or authorization issues.

![Technical Errors table, white background, text-based data.](https://a.allegroimg.com/s1200/125747/21c71b04450785812a255a050b72 'Technical Errors table, white background, text-based data.')

* **Business errors:** result directly from the logic of operational processes on Allegro, such as rule validation when creating or editing offers.

![Business Errors Page, Black background, Text-based, Displays error codes and messages.](https://a.allegroimg.com/s1200/12635e/ce66a5434ad1bdf3a252e0cee57a 'Business Errors Page, Black background, Text-based, Displays error codes and messages.')

Additionally, the **business errors list** allows for detailed tracking of their occurrences. Each item on the list contains the exact error code, a clear description for the user, and the path (endpoint), which speeds up the identification of the root cause.

**Future Plans and Your Feedback**

This is the first phase of the new panel's development. We plan to introduce additional metrics to help you monitor your application even more thoroughly.

We want to develop this tool based on your real needs and feedback. If you have ideas for new charts or want to report technical comments, you can send us your opinion directly from the panel using the **"Add chart"** button.

贡献指南

这个仓库没有索引到贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。