API:Etiquette/pl

Trwają prace nad tą stroną.

Przeczytaj też szybki przewodnik rozpoczynający. Odpowiada on na niektóre pytania, których tutaj nie ma oraz wskazuje na inne użyteczne strony.

Pomoc

 * 1) Przeczytaj to FAQ.
 * 2) Spróbuj znaleźć odpowiedź na swoje pytanie w dokumentacji API lub w stronę główną wbudowanej w API dokumentacji.
 * 3) Jeżeli nie możesz znaleźć odpowiedzi na swoje pytanie w sieci, możesz zadać je na liście dyskusyjnej mediawiki-api.

Limity żądań
Nie ma limitu twardości i szybkości w żądaniach odczytu, ale prosimy o byciu rozsądnym i nie spowodowanie przeciążenia strony. Większość operatorów zastrzega sobie prawo do bezceremonialnego zablokowania, jeżeli Twoje działania zagrażają stabilność strony.

Jeżeli wywołujesz żądania po kolei, zamiast równolegle (tj. czekasz na zakończenie wcześniejszego żądania zanim zostanie wysłane nowe, co oznacza, że nigdy nie wykonujesz więcej niż jedno żądanie w tym samym czasie), to powinno być wszystko dobrze. Also try to combine things into one request. For example: specify multiple '|'-separated titles in a  parameter instead of making a new request for each title; use a "generator" instead of making a request for each result from another request.

Parsing of revisions
While it is possible to query for results from a specific revision number this is an expensive operation for the servers. To retrieve a specific revision use the 'oldid' parameter, example:


 * [//en.wikipedia.org/w/api.php?action=parse&format=xml&prop=images&oldid=254862759 en.wikipedia.org/w/api.php?action=parse&format=xml&prop=images&oldid=254862759]
 * [//en.wikipedia.org/w/api.php?action=parse&format=xml&prop=images&oldid=462841413 en.wikipedia.org/w/api.php?action=parse&format=xml&prop=images&oldid=462841413]

Use maxlag parameter
If your task is not interactive (i.e. A user is not waiting for the result) you should use the maxlag parameter. This will prevent your task from running when the load on the servers is high. Higher values mean more aggressive behavior, lower values are nicer.

See:

User-Agent header
Use a descriptive  header that includes your application's name and potentially your email address if appropriate. Do not simply copy the user-agent of a popular web browser (Unless your API client is a JavaScript application running through said web browser via Ajax, in which case one cannot modify the user-agent). This ensures that if a problem does arise it is easy to track down where it originates. See API:Main page#Identifying your client and m:User-Agent policy for details.

Thinking about performance generally
If you are trying to figure out why you are getting results more slowly than you would like, try to help you think about performance generally. If you are finding that reading via the API rather than directly reading from databases is impeding your client's performance, consider whether to put it into Wikimedia's Tool Labs.