REST API İstemcisi / Sınayıcı

Sorgu parametreleri, başlıklar, JSON / form gövdeleri ve Basic veya Bearer kimlik doğrulaması ile HTTP istekleri oluşturup gönderin, ardından durumu, süreyi ve biçimlendirilmiş JSON yanıtlarını inceleyin. Mevcut bir cURL komutunu içe aktarın ya da geçerli isteği cURL olarak geri kopyalayın. Adım adım yeniden kullanılabilir istekler mi oluşturmak istiyorsunuz? HTTP İstek Oluşturucu'yu kullanın. Ayrıca API Araçları ailesine bakın.
Her şey tarayıcınızda yerel olarak çalışır. Çapraz kaynak istekleri hedef sunucunun CORS politikasına tabidir — bir istek başarısız olursa aşağıdaki nota bakın.
Bir cURL komutu yapıştırın
Sorgu Parametreleri
Üstbilgiler
Gövde
Yetkilendirme
Seçenekler
Doldurulduğunda, istek URL'si bu öneke eklenir. CORS engelli sunucular için kullanışlıdır.
200
Gövde Başlıklar

                                                                

                                                                

                                                                    

                                                                

                                                            


                                                            

                                                            
İstek neden başarısız olabilir: API Access-Control-Allow-Origin döndürmedikçe tarayıcılar çapraz kaynak okumalarını engeller. Hedef CORS'a izin vermiyorsa kendi CORS proxy'nizi çalıştırıp adresini yukarıdaki proxy önekine yapıştırabilir ya da isteği bir terminalden çalıştırmak için cURL Dönüştürücü'yü kullanabilirsiniz. GET/HEAD istek gövdeleri yok sayılır; bir WebSocket aracı ise ayrıdır: WebSocket Test Aracı.


                                                            

                                                                HTTP yöntemleri açıklanmış
                                                                
Seçtiğiniz yöntem, sunucuya URL ile ne yapılmasını istediğinizi söyler. Bu aracın gönderebildiği yedi fiilin her birinin anlamı şudur:

                                                                
GET — Bir kaynağı getirir: bir web sayfası, bir görsel, bir kayıt listesi. “Bu adreste ne varsa bana ver.” Salt okunurdur ve tekrarlanması güvenlidir; normalde bir istek gövdesi taşımaz (bir GET isteğindeki gövde, varsa, yok sayılır).

                                                                
POST — Sunucuya yeni veri gönderin, genellikle bir kaynak oluşturmak ya da bir eylemi tetiklemek için — bir formu göndermek, bir dosya yüklemek, bir iş başlatmak. Yük istek gövdesinde taşınır. POST idempotent değildir: aynı POST'u iki kez göndermek iki kayıt oluşturabilir.

                                                                
PUT — URL'deki tüm kaynağı gönderdiğinizle değiştirin. Gövde kaynağın eksiksiz yeni sürümünü taşımalıdır. PUT idempotent'tir: aynı isteği yinelemek, bir kez göndermekle aynı etkiyi verir.

                                                                
PATCH — Bir kaynağın yalnızca bir kısmını değiştirin. Tüm kaydı değil, yalnızca güncellemek istediğiniz alanları gönderirsiniz, ör. {"email": "new@example.com"}. Tam bir PUT dokunmadığınız alanları yeniden göndermenizi gerektirecekse PATCH'i seçin.

                                                                
DELETE — URL'deki kaynağı kaldırır. DELETE idempotent'tir (yinelenebilir): zaten silinmiş bir şeyi silmek aynı sonucu verir (genellikle 404) ve iki kez bir şey yapmaz.

                                                                
HEAD — Tıpkı GET gibi, ancak yanıt yalnızca başlıkları içerir — geri hiç gövde gönderilmez. HEAD'i bir URL'nin var olup olmadığını, bir dosyanın ne kadar büyük olduğunu (Content-Length), ne zaman değiştirildiğini (Last-Modified) ya da türünün ne olduğunu (Content-Type) tüm yükü indirmeden kontrol etmek için kullanın.

                                                                
OPTIONS — Sunucuya bir URL için hangi yöntemlerin ve seçeneklerin izinli olduğunu sorun ya da bir CORS ön kontrolünü tetikleyin. Access-Control-Allow-Methods gibi yanıt başlıkları neyin izinli olduğunu listeler. OPTIONS genellikle gövde taşımaz; tarayıcılar çapraz kaynak POST/PUT/PATCH/DELETE öncesinde bunu genellikle otomatik gönderir.

                                                                
Karıştırması kolay: HEAD ve GET — istek aynıdır, ancak HEAD gövde döndürmez. PUT ve PATCH — PUT kaynağın tamamını değiştirir; PATCH yalnızca gönderdiğiniz alanlarda kısmi güncelleme uygular.