API:FAQ/tr

Genel bakış
Bu sayfa, MediaWiki Eylem API hakkında sıkça sorulan bazı soruların yanıtlarını sağlar.

Ayrıca sayfasını okuyunuz. Burada cevaplanamayan bazı soruları cevaplayabilir ve diğer yararlı sayfalara yönlendirebilir.

API nedir?
API, Uygulama Programlama Arayüzü ifadesinin kısaltmasıdır. Farklı uygulamaların birbirleriyle iletişim kurmasını sağlar. Genel olarak HTTP-yanıt mekanizmasını kullanan ve JSON/XML yapılandırılmış verisi üreten web tabanlı API isteklerine atıfta bulunur.

REST API nedir?
REST, Representational State Transfer ifadesinin kısaltmasıdır. A yol gösterici ilkeler veya kısıtlamalar dizisi, RESTli bir sistem tanımlar. Bir RESTful API veya yalnızca bir REST API, bu ilkelere bağlı kalır ve bu nedenle daha hızlı, daha güvenilir ve ölçeklenebilir bir hizmettir.

Bir API ne yapabilir?
Bazı API'nin kullanımlara bakın.

API'ler hakkında nereden daha fazla bilgi edinebilirim?
İşte birkaç kaynak:


 * API'leri anlama
 * API'lere giriş
 * REST nedir — Yeni Başlayanlar İçin Basit Bir Açıklama, Bölüm 1: Giriş

MediaWiki Eylem API'si nedir?
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.

MediaWiki Eylem API'si ne için kullanılabilir?
MediaWiki Eylem API'si şu amaçlarla kullanılabilir:


 * viki özellikleri erişim.
 * bir viki ile etkileşim kurun.
 * vikiler ve genel kullanıcılar hakkında meta bilgiler elde edin.

Sağ kenar çubuğu, API tarafından desteklenen birçok özelliğe işaret eder. Ayrıca, MediaWiki Eylem API'sini kullanan Wikimedia projelerine bakın.

MediaWiki Eylem API'sini nasıl kullanabilirim (veya çağırabilirim)?
HTTP istekleri, genellikle Eylem API'sini çağırmak için kullanılır. Ayrıntılı talimatlar için eğitim sayfasına bakın.

Eylem API ile oynamak için:


 * Special:ApiSandbox kullanın.
 * Tarayıcınızın geliştirici konsolunu etkinleştirin ve viki ile etkileşime girerken net istekleri  ile izleyin.

Bir modül, bir alt modül ve bir parametre nedir?
MediaWiki Eylem API'si, farklı görevleri gerçekleştirmek için kullandığımız çok sayıda modüle sahiptir. Teknik açıdan, bir modül ApiBase öğesinin bir alt sınıfıdır. Bir modül parametreler gerektirir. Bu parametreler alt modüller olabilir (veya olmayabilir).

Aşağıdaki isteği göz önünde bulundurun: here:


 * , ana modülün parametredir.
 * , başka bir modüldür. modül sorgusu denilir.
 * , modül sorgusunun parametresidir.
 * ayrıca bir modüldür.  bir alt modül olarak adlandırılabilir.
 * , arama modülünün parametresidir. 'abc' arama dizesini tutar.
 * , ana modülün parametredir.
 * çıkış biçimidir.

Ayrıca Giriş ve yönergelere bakın. modülünün alt modüllerini açıklar.

Hangi modül ve alt modülün çağrılacağını nasıl bilebilirim?
MediaWiki Eylem API'si büyüktür ve uzantılar onu daha da büyütür. API isteğinizi gerçekleştirmenin birkaç yolu:


 * Kenar çubuğunda, uygulamak istediğiniz özelliği arayın ve hangi modüllerin çağrılacağı hakkında bilgi için bağlantıyı izleyin.
 * Kendi kendini belgeleyen API sayfaları, kısa açıklamalarla birlikte tüm modüllerin ve alt modüllerin bir listesini içerir. Ana modülden başlayabilir ve farklı alt modüllere giden bağlantıları takip edebilirsiniz. (Genişletilmiş sürümü görüntülemek için  ekleyin)

API modüllerini kullanmak için örnek kodları nerede bulabilirim?
API belgeleri sayfaları, farklı modüllerin ve alt modüllerin nasıl kullanılabileceğini gösteren bir 'Örnekler' bölümü içerir. Otomatik oluşturulan belgeler ayrıca modül açıklamalarını takip eden örneklere sahiptir.

Python ve JavaScript'teki kod parçacıkları için Mediawiki-API-demos adresine bakın.

Çıkış biçimi nasıl kontrol edebilirim?
Varsayılan çıkış biçimi JSON'dur. Diğer çıkış biçimleri, en son kararlı MediaWiki sürümünde kullanımdan kaldırıldı veya kaldırıldı ve bunların kullanılması önerilmez.

Eski sürümlerde, çıkış biçimini kontrol etmek için sorgu dizesine  iletebilirsiniz.

Bilgi için API:Veri biçimleri sayfasına.

Erişim anahtarına ihtiyacım var mı?
Oturum açma, düzenleme, sayfaları taşıma vb. gibi verileri değiştirme eylemlerini gerçekleştirmek için bir erişim anahtarını ihtiyacınız olacak.

Daha fazla bilgi edinmek için API:Tokens veya kenar çubuğu kategorisi ​​'Kimlik doğrulama' bakın.

API'yi kullanarak siteler arası isteklerde nasıl bulunabilirim?
MediaWiki'de siteler arası isteklerde bulunmak için JSONP veya CORS kullanmalısınız.

Ayrıntılar için API:Siteler arası istekler sayfasına bakın.

Sorgulama sonuçları için bir sınır var mı?
Yes, it depends on the query parameter. For example, the results for  and   queries cannot exceed 500 for regular users. The API pages contain information about these limits in the 'Additional notes' section or the 'Limits' section. Note that some modules impose stricter limits under certain conditions.

If you are unsure about what limit to set and just want as many results as possible, set the limit to.

API çağrılarının bir sınırı var mı?
There is no concrete limit. Yet, we recommend making a reasonable number of calls to prevent getting blocked. If you want to make many requests, contact the administrators beforehand.

Also, see API:Etiquette.

MediaWiki Eylem API ile ilgili güncellemeleri nereden alabilirim?
You can subscribe to the MediaWiki-API-Announce mailing list for announcements and updates.

Viki dökümleri nedir ve bunlarla nasıl çalışabilirim?
Wikimedia’s data dumps are dumps of wiki collections, content, metadata, search indices, etc. To work with dumps, see using dumps and public dumps.

Nereden daha fazla yardım alabilirim?
If you can't find answers in the MediaWiki API documentation or the auto-generated documentation pages, feel free to reach out in the following ways.


 * Bir Wikimedia hesabı oluşturun (eğer henüz bir hesabınız yoksa) ve API tartışma sayfasında yeni bir konu ekleyin.
 * Ask your question on:
 * IRC in the channel.
 * MediaWiki-API mailing list.

How can I create an API module in an extension?
API:Extensions will walk you through the complete process of creating an API module in an extension.

API'nin dahili yapısı nedir?
API:Implementation Strategy explains the implementation of the API machinery in MediaWiki Core.

API kullanımını nasıl kısıtlayabilirim?
To restrict the API usage, you can either restrict the use of write API or disable individual modules.

For instructions and examples, see API:Restricting API usage.

Kullanıcıların API'yi kullanarak viki içeriğini değiştirmesine nasıl izin verebilirim / kısıtlayabilirim?
In MediaWiki 1.14, users are allowed to modify the wiki content by default. To restrict, you have to set  in.

In MediaWiki 1.13 or earlier, you have to enable the write API with  to allow content modification.

For more information, see API:Changing wiki content.

Hatayı nasıl bulabilirim?
If you encounter an error, the error response from the API will set the  HTTP header and return an error structure.

Bu hata ne anlama geliyor?
Find your error in the list of standard error messages to understand what the error means.

Hata/özellik isteklerini nasıl iletebilirim?
You can report bugs and file feature requests on Wikimedia's task tracking tool, Phabricator.

Not:


 * Add the MediaWiki-API project tag to your task.
 * If your report/request is offered by an extension, add that extension's project. (e.g. MediaWiki-extensions-AbuseFilter,  MediaWiki-extensions-FlaggedRevs, etc.)
 * Verify for duplicates before creating a new task.
 * Understand the task creation terms on Phabricator before proceeding.

See How to report a bug for more details.

API sürümüm nedeniyle hatalarla mı karşılaşıyorum?
If a website runs a different version of MediaWiki, it would also run a different version of the API. Some module parameters supported in one version might be deprecated (or removed) in others. Such parameters will throw an exception if used. The API pages document any such deprecations.

See the release notes for information regarding different API versions.