API:Tutorial/tr

Bu eğitimde, MediaWiki Eylem API'si, nasıl kullanılacağı, istek biçimi, basit bir sorgu ve Eylem API kullanan proje örnekleri hakkında bilgi edineceksiniz.

Toolforge'da demo uygulamalarına göz atın



MediaWiki Eylem API'sine genel bakış
MediaWiki Eylem API'si, kullanıcıların aşağıdaki gibi belirli sayfa oluşturma, kimlik doğrulama, ayrıştırma, arama vb. viki eylemlerini gerçekleştirmesine olanak tanıyan bir REST'li web hizmetidir. , API'yi anlamak için iyi bir başlangıç noktasıdır.

Programınız, viki özelliklerine erişim elde etmek için API'ye istek gönderir. Örneğin, bir vikide oturum açın, bir sayfa oluşturun ve düzenleyin, bir başlık arayın, içerik metni arayın veya içeriği ayrıştırın. Eylem API, üçüncü taraf geliştiriciler, Wikimedia uzantı geliştiricileri ve wiki sitesi yöneticileri tarafından kullanılabilir.

Bu sayfanın sağ yan çubuğunda, kategorilerle gruplanan ve API tarafından desteklenen birçok özellik vardır. Bir wiki sunucusuna istek göndermeden önce, veri biçimleri, hatalar ve uyarılar ve Eylem API'sı için SSS vb. genel bakış sayfalarını okuyunuz.



MediaWiki Eylem API'si nasıl kullanılır
w:Hypertext_Transfer_Protocol 9:1TP üzerinden kullanıcıdan sunucuya veri talep edebilir ve cevapları standart bir biçimde (genellikle w:JSON 9:1JSON olarak) alabilirsiniz. Bir talep, bitiş noktası ve bir dizi parametreden oluşur. Yapılabilecek iki tür talep vardır: Hypertext_Transfer_Protocol ve POST_ (HTTP) ⁇ POST. For a GET request, a parameter would contain a query string in the URL. For a POST request, format the parameters in JSON format.



İstek biçimi
All Wikimedia Wikis have endpoints in this format. To operate on the MediaWiki main site or English Wikipedia, use the related endpoint. For example, the English Wikipedia is at. For testing new accounts or test edits to pages, use the test wiki endpoint.

In the query string in the URL, add the  parameter. It tells the API which action to perform. The most popular action is  (the URL would contain ), which allows fetching data from a wiki. Following the  parameter, add another parameter to indicate which one of the three query module types you want to perform:


 * - get properties of pages
 * - get list of pages matching a certain criterion
 * - get meta information about the wiki and user

Finally, include the  parameter, which tells the API in which format to get the results. The recommended format is JSON. The API has supported other output formats in the past, but they are not generally recommended.



Basit bir sorgu
GET'in tipik bir istek ve cevabının Action API bağlamına nasıl görüneceğini anlamak için basit bir sorunun örneğini alalım.

Bir wiki'de bir başlık arayalım. 'de belgelenmiş olan  modülünü kullanacağız.



GET isteği
$ 1 ile eşleşen sayfa başlıklarını veya içeriklerini aramak için HTTP GET isteği için URL vu olurdu :URL'nin her bir kısmının açıklaması:


 * ana bitiriş noktasıdır. Bu durumda İngilizce Wikipedia.
 * , wiki'den veri almak anlamına gelir.
 * bir kriterle eşleşen sayfaların listesini elde etmek anlamına gelir.
 * arama yapılacak sayfa başlığını veya içeriğini ifade eder.  bir URL'de bir boşluk karakterini ifade eder.
 * önerilen çıktı biçimi olan JSON çıktısını gösterir.

Yanıt
Cevap, "Craig Noone" ile eşleşen sayfa başlıklarının bir listesi olan JSON biçimindeki bir belgedir.



Eylem API'sı kullanan proje örnekleri
Some example of projects in Wikimedia that use Action API:


 * Wikipedia iOS App, in which one of the features is to search for wiki pages near your location.
 * Bots that operate on a wiki. Pywikibot is a bot framework written in Python that interfaces with MediaWiki API which a lot of bot developers use.
 * API use in visualizing data obtained from a wiki. Such as this neat visualization that shows real time edits made on Wikipedia.



Ek notlar

 * Several sites are using MediaWiki. They might all be running a different version of MediaWiki and in turn the API. Some module parameters supported in one version might be deprecated or removed in others. You could learn about that in each module's documentation via API help module.
 * If you want to make a lot of API calls, and perhaps run very busy and active bots, talk to wiki admins ahead of time, so they do not block you. See list of Administrators of Wikimedia projects. Read more about this topic on.
 * All data modifying actions such as logging, editing or moving a page, and watching or patrolling changes would require tokens. You would need to obtain tokens via to proceed further.

Kaynaklar

 * Use Special:APISandbox to experiment with the Action API. You can play around with supported actions, specify a value for parameters, and send requests to the API to see the results on the same page.
 * Wikimedia dumps so you can work with them locally.
 * Read through tutorials: An Introduction to API's and What is REST — A Simple Explanation for Beginners.
 * MediaWiki API help provides auto-generated API documentation of all supported modules.
 * provides an overview of the Action API.
 * Introduction to the MediaWiki API by User:Roan_Kattouw_(WMF) at the San Francisco Hackathon, 2012. This tutorial guide goes along with the video.
 * GitHub: MediaWiki API Demoları