├── .github ├── ISSUE_TEMPLATE │ ├── ---bug-report---rest-api.md │ ├── --question.md │ └── discussions_template.md ├── no-response.yml └── stale.yml ├── README.md └── allegro-api-logo.png /.github/ISSUE_TEMPLATE/---bug-report---rest-api.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: "\U0001F41B Bug report - REST API" 3 | about: Zgłoś błąd dotyczący REST API Allegro / Report a REST API Allegro bug 4 | 5 | --- 6 | 7 | Występuje problem: 8 | - [ ] z zasobem REST API / with a REST API resource 9 | - [ ] ze środowiskiem produkcyjnym / with the production environment 10 | - [ ] ze środowiskiem testowym / with the test environment 11 | - [ ] z logowaniem lub autoryzacją / with login or authorization 12 | - [ ] na portalu https://developer.allegro.pl/ / at https://developer.allegro.pl/en/ 13 | - [ ] inny / other 14 | 15 | :beetle: **Opis / Description** 16 | 17 | 18 | 19 | 25 | 26 | 33 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/--question.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: "❓ Question" 3 | about: Zadaj pytanie dotyczące REST API Allegro / Ask about REST API Allegro 4 | 5 | --- 6 | 7 | 8 | 9 | 23 | 36 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/discussions_template.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: "\U0001F4A1 Ideas" 3 | about: Sugestie dotyczące REST API Allegro / Suggestions for REST API Allegro 4 | 5 | --- 6 | :bulb: **Sugestia / Suggestions** 7 | 8 | [English version below] 9 | 10 | Masz sugestie dotyczące REST API Allegro? Skorzystaj z działu [Discussions](https://github.com/allegro/allegro-api/discussions) - dzięki temu inni użytkownicy również będą mogli oddać na nią swoje głosy. [Zapoznaj się z zasadami korzystania z forum API Allegro na GitHubie](https://github.com/allegro/allegro-api/wiki#zasady-korzystania-z-forum-api-allegro-na-githubie). 11 | 12 | ----------- 13 | Do you have suggestions for REST API Allegro? Use the [Discussions](https://github.com/allegro/allegro-api/discussions) section - this will also allow other users to vote for it. [Read the rules for using the Allegro API forum on GitHub](https://github.com/allegro/allegro-api/wiki#rules-for-using-the-allegro-api-forum-on-github). 14 | -------------------------------------------------------------------------------- /.github/no-response.yml: -------------------------------------------------------------------------------- 1 | # Configuration for probot-no-response - https://github.com/probot/no-response 2 | 3 | # Number of days of inactivity before an Issue is closed for lack of response 4 | daysUntilClose: 7 5 | # Label requiring a response 6 | responseRequiredLabel: czekamy_na_dane 7 | # Comment to post when closing an Issue for lack of response. Set to `false` to disable 8 | closeComment: > 9 | Automatycznie zamknęliśmy wątek, ponieważ nie otrzymaliśmy niezbędnych danych. 10 | Jeśli problem nadal występuje, to wznów wątek i prześlij do nas informacje, o które prosiliśmy. 11 | -------------------------------------------------------------------------------- /.github/stale.yml: -------------------------------------------------------------------------------- 1 | # Number of days of inactivity before an issue becomes stale 2 | daysUntilStale: 7 3 | # Number of days of inactivity before a stale issue is closed 4 | daysUntilClose: 7 5 | # Issues with these labels will never be considered stale 6 | exemptLabels: 7 | - news 8 | - In verification 9 | # Set to true to ignore issues in a project (defaults to false) 10 | exemptProjects: false 11 | 12 | # Set to true to ignore issues in a milestone (defaults to false) 13 | exemptMilestones: false 14 | 15 | # Set to true to ignore issues with an assignee (defaults to false) 16 | exemptAssignees: false 17 | 18 | # Label to use when marking an issue as stale 19 | staleLabel: brak_odpowiedzi 20 | # Comment to post when marking an issue as stale. Set to `false` to disable 21 | markComment: 22 | 23 | W tym wątku nie pojawiła się żadna nowa odpowiedź w ciągu 7 dni, dlatego automatycznie oznaczamy go jako przeterminowany. Jeśli w ciągu kolejnych 7 dni nie pojawi się żadna odpowiedź, wątek zostanie zamknięty. 24 | Dziękujemy za zaangażowanie w dyskusję i zachęcamy Cię do wypełnienia [ankiety](https://docs.google.com/forms/d/1CYjSAQoHzudrGOrI8Bmb8HJzgyy4MZut5aAacitYkFw) dotyczącej naszego wsparcia na forum. 25 | 26 | 27 | ------ 28 | 29 | There was no new reply in this thread within 7 days, therefore, we automatically marked it as expired. If no response is received within the next 7 days, this thread will be closed. 30 | Thank you for engaging in the discussion. We encourage you to complete our forum support [survey](https://docs.google.com/forms/d/1ewSE9w07tNyvi8LTTDue54Y1tI5p5Sog_loevheEbRM). 31 | # Comment to post when closing a stale issue. Set to `false` to disable 32 | closeComment: false 33 | only: issues 34 | 35 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # ![Allegro API](https://raw.githubusercontent.com/allegro/allegro-api/master/allegro-api-logo.png) 2 | 3 | Dzięki projektowi API Allegro na Githubie, możesz: 4 | 5 | * dowiedzieć się o zmianach, które wprowadzamy w naszym API, 6 | * zadać pytanie, które dotyczy tego interfejsu, 7 | * zaproponować sugestię - co możemy dodać lub zmienić w API, 8 | * zgłosić błąd. 9 | 10 | # Jak zadawać pytania i zgłaszać problemy na GitHubie? 11 | Wejdź w zakładkę **[Issues](https://github.com/allegro/allegro-api/issues)**, załóż nowe zgłoszenie i skorzystaj z odpowiedniego szablonu. Pamiętaj, aby w zgłoszeniu podać jak najwięcej dokładnych informacji - dzięki temu szybciej uzyskasz pomoc. 12 | 13 | 14 | Jeżeli masz jakieś sugestie, lub chcesz je przejrzeć i zagłosować - skorzystaj z zakładki [**Discussions**](https://github.com/allegro/allegro-api/discussions). 15 | 16 | ## Czym jest API Allegro 17 | API to usługa sieciowa, która umożliwia wymianę informacji między zasobami Allegro, a oprogramowaniem zewnętrznym. Dzięki niej możesz zintegrować własne rozwiązania z mechanizmami serwisu. W ramach API Allegro udostępniamy szereg zasobów, które odpowiadają poszczególnym funkcjom serwisu. 18 | 19 | W Allegro korzystamy z **[REST API](https://developer.allegro.pl/tutorials/informacje-podstawowe-b21569boAI1#rest-api)**. 20 | 21 | * Zasoby, które udostępniliśmy w Allegro REST API opisaliśmy w **[dokumentacji](https://developer.allegro.pl/documentation/)**. 22 | * Poradniki i przykłady wywołań w Allegro REST API znajdziecie w **[aktualnościach](https://developer.allegro.pl/news/)**. 23 | 24 | ## Nowości w API Allegro 25 | 26 | Jeżeli chcesz być na bieżąco z nowościami w ramach naszego publicznego API: 27 | 28 | * przejdź na stronę **[Newsletter](https://developer.allegro.pl/newsletter)** i kliknij w "Zapisz się", aby otrzymywać od nas automatyczne powiadomienia e-mail dotyczące zmian w API Allegro, 29 | * do naszego newslettera możesz zapisać się również na stronie **[Aktualności](https://developer.allegro.pl/news)**, 30 | * o nowościach informujemy także na GitHubie w zakładce **[Issues](https://github.com/allegro/allegro-api/issues)** - wątki tagujemy znacznikiem [NEWS]. 31 | 32 | ## API Allegro Status Page 33 | 34 | Udostępniamy [Status Page publicznego API Allegro](https://api.allegrostatus.pl/). Dzięki temu narzędziu otrzymasz przejrzyste aktualizacje dotyczące incydentów i wszelkich nadchodzących prac serwisowych. 35 | 36 | [Status Page](https://api.allegrostatus.pl/) podzielony jest wg grup funkcjonalności, zgodnie z dokumentacją publicznego API Allegro. 37 | 38 | 39 | ## Zasady korzystania z forum API Allegro na GitHubie 40 | 41 | 1. Jako zespół wsparcia publicznego API Allegro nadzorujemy i moderujemy treści umieszczane na forum API Allegro na GitHubie. Zastrzegamy sobie prawo do edytowania, usuwania (w całości lub w części), bez uprzedzenia, opublikowanych na forum treści w przypadku ich sprzeczności z obowiązującymi przepisami prawa oraz zasadami forum. 42 | 43 | 2. Dobre praktyki: 44 | 45 | * nie powielaj wątków - użyj wyszukiwarki i sprawdź czy twój temat był już poruszany, być może znajdziesz od razu odpowiedź na swoje pytanie, 46 | * z każdym nowym tematem utwórz nowy wątek, 47 | * gdy chcesz zgłosić błąd, opisz szczegółowo sytuację i podaj dane, które pozwolą na weryfikację: środowisko, zasób, trace-id, commandId lub podaj pełne cURL z responsem i requestem (możesz je nam przekazać przez [**formularz kontaktowy**](https://allegro.pl/pomoc/kontakt) - w zgłoszeniu podaj numer wątku na GitHubie), 48 | * nie wysyłaj wielokrotnie tej samej wiadomości (spam) lub wielu różnych wiadomości w bardzo krótkich odstępach (flooding), 49 | * dziel się swoją wiedzą, 50 | * jeśli chcesz zgłosić sugestię zmiany w API Allegro skorzystaj z zakładki [**Discussions**](https://github.com/allegro/allegro-api/discussions). 51 | 52 | 3. Zabrania się zamieszczania postów sprzecznych z obowiązującymi przepisami prawa, normami obyczajowymi, moralnymi i społecznymi, w szczególności zabrania się umieszczania treści, które: 53 | 54 | * są nieprawdziwe, wprowadzające lub mogące wprowadzać w błąd, 55 | * mogą naruszać prawa autorskie lub inne prawa własności intelektualnej, 56 | * naruszają prawa podmiotów trzecich, 57 | * naruszają dobra osobiste, 58 | * zawierają wrażliwe dane np. token dostępowy i dane osobowe (tego rodzaju treści przekaż nam przez [**formularz kontaktowy**](https://allegro.pl/pomoc/kontakt) z dopiskiem wątku na GitHubie, którego to dotyczy), 59 | * są dyskryminujące (m.in. płeć, rasa, narodowość, język, religia), nawołujące do przemocy lub posiadające charakter pornograficzny, 60 | * są obraźliwe, wulgarne lub zawierające groźby, 61 | * są bezpośrednimi atakami na innych użytkowników forum, 62 | * nie mają związku z tematyką dyskusji prowadzonych w ramach forum, 63 | * zawierają rady, które mogłyby skutkować wyrządzeniem szkody lub popełnieniem czynu karalnego, 64 | * rozpowszechniania lub nakłaniania do pobierania wirusów komputerowych lub złośliwego/szkodliwego oprogramowania, 65 | * propagują ideologię polityczną, religijną lub inną. 66 | ________ 67 | 68 | # ![Allegro API](https://raw.githubusercontent.com/allegro/allegro-api/master/allegro-api-logo.png) 69 | 70 | Through the Allegro API project on Github, you can: 71 | 72 | * find out about the changes we are making to our API, 73 | * ask a question that relates to this interface, 74 | * propose a suggestion - what we can add or change in the API, 75 | * report a bug. 76 | 77 | # How to ask questions and report problems on GitHub? 78 | 79 | Go to the **[Issues](https://github.com/allegro/allegro-api/issues)** tab, create a new issue and use the appropriate template. Remember to provide as much accurate information as possible in your submission - this will allow us to help you faster. 80 | 81 | If you have any suggestions, or want to review and vote on them - use the [**Discussions**](https://github.com/allegro/allegro-api/discussions) tab. 82 | 83 | ## What is the Allegro API 84 | 85 | API is a web service that allows exchanging of information between Allegro resources and external software. It allows you to integrate your own solutions with the mechanisms of the service. As part of the Allegro API, we provide a number of resources that correspond to the service's various functions. 86 | 87 | At Allegro, we use the **[REST API](https://developer.allegro.pl/tutorials/basic-information-VL6YelvVKTn#rest-api)**. 88 | 89 | * The resources we have provided in Allegro REST API are described in the **[documentation](https://developer.allegro.pl/documentation)**. 90 | * You can find tutorials and examples of Allegro REST API requests on **[our devportal](https://developer.allegro.pl/)**. 91 | 92 | ## News in Allegro API 93 | 94 | If you want to be up to date with new features in our public API: 95 | 96 | * go to the **[Newsletter](https://developer.allegro.pl/newsletter)** page and click the "Subscribe" button, to receive automatic e-mail notifications from us regarding changes to the Allegro API, 97 | * you can also subscribe to our newsletter on the **[News](https://developer.allegro.pl/news)** page, 98 | * we also inform about news in API in the **[Issues](https://github.com/allegro/allegro-api/issues)** tab on GitHub - threads are labeled with the [NEWS] tag. 99 | 100 | ## API Allegro Status Page 101 | 102 | We provide the [Status Page of Allegro's public API](https://api.allegrostatus.pl/). This tool will give you clear updates on incidents and any upcoming maintenance work. 103 | 104 | The [Status Page](https://api.allegrostatus.pl/) is divided by functionality groups, in line with Allegro public API documentation. 105 | 106 | 107 | ## Rules for using the Allegro API forum on GitHub 108 | 109 | 1. As the Allegro API public support team, we oversee and moderate content posted on the Allegro API forum on GitHub. We reserve the right to edit, remove (in whole or in part), without notice, content published on the forum in case it conflicts with applicable laws and forum rules. 110 | 111 | 2. Best practices: 112 | 113 | * don't duplicate threads - use a search tool and see if your topic has already been discussed, you may find the answer to your question right away, 114 | * create a new thread with each new issue, 115 | * when you want to report a bug, describe the situation in detail and provide data that will allow verification: environment, resource, trace-id, commandId or provide a full cURL with response and request (you can send it to us through the [**contact form**](https://allegro.pl/pomoc/kontakt) - in the request, provide the thread number on GitHub), 116 | * do not send the same message repeatedly (spam) or many different messages in very short intervals (flooding), 117 | * share your knowledge, 118 | * if you want to make a suggestion for a change to the Allegro API, use the [**Discussions**](https://github.com/allegro/allegro-api/discussions) tab. 119 | 120 | 3. It is forbidden to publish posts that are contrary to applicable law, moral and social norms. In particular, it is forbidden to publish content that: 121 | 122 | * are untrue, misleading, or potentially misleading, 123 | * may infringe copyrights or other intellectual property rights, 124 | * infringe the rights of third parties, 125 | * infringe any personal rights, 126 | * contain sensitive data, e.g., access token and personal information (submit this kind of content to us via the [**contact form**](https://allegro.pl/pomoc/kontakt) - in the request, provide the thread number on GitHub), 127 | * discriminate (on account of sex, race, nationality, language, religion, etc.), incite violence, or contain pornographic content, 128 | * are offensive, vulgar or contain threats directed at third parties, 129 | * are direct attacks on other forum users, 130 | * are not related to the subject matter of the discussions held within the forum, 131 | * contain advice that could result in causing damage or committing an offence, 132 | * disseminate or solicit others to download computer viruses or malicious/harmful software, 133 | * conduct political, religious, or other agitation. 134 | -------------------------------------------------------------------------------- /allegro-api-logo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/allegro/allegro-api/9fe58fd2b3623189e9e2f4ee91e96052b30e2477/allegro-api-logo.png --------------------------------------------------------------------------------