API request payload'unu gondermeden once temizle, dogrula ve okunur hale getir.
Sorunlarin bir kismi response tarafinda degil, request daha yola cikmadan once baslar. Query param encode eksigi, bozuk JSON veya ne tasidigini bilmediginiz bir Base64 parca ayni ticket'i uzatir. Bu guide, payload hazirlama akisini tek yerde toplar.
4 adimli request hazirlama akisi
-
1. Query param degerlerini ayri encode et
Ozellikle bosluk, `&`, `+`, `=` veya Turkce karakter iceren parametreleri tum URL yerine deger bazinda encode etmek daha kontrollu sonuclar verir. URL Encode araci query parcalarini ve parser gorunumunu ayni yerde sunar.
-
2. JSON body'yi formatla ve validate et
Request body'niz JSON ise, field duzeni ve syntax hatalarini response beklemeden yakalamak gerekir. JSON Formatter bu asamada format, minify ve validate ile erken hata ayrimi saglar.
-
3. Base64 veya URL-safe parcayi decode et
Request icinde Base64 bir alan varsa ne tasidigini gormeden debug etmek zordur. Base64 araci ile URL-safe varyanti dahil decode ederek parcanin JSON mu, duz metin mi yoksa baska bir icerik mi oldugunu anlayabilirsiniz.
-
4. Hassas veriyi maskeleyip paylasilabilir hale getir
Payload debug ciktisini ekip icinde paylasmadan once token, e-posta, telefon veya musteri ID gibi alanlari maskeleyin. Client-side ve API-backed tool farkini da buna gore degerlendirin.
En sik 3 payload hatasi
Butun URL encode edilince separator karakterleri de donusur ve hangi kisim bozuk oldugunu ayiklamak zorlasir. Genelde yalnizca ilgili parametre degeri encode edilir.
Tek tirnak, sondaki virgul veya hatali escape karakteri response tarafinda genel 400 hatasi olarak doner. Format/validate adimi bunu erken ayirir.
Base64 sadece donusumdur. Request body icindeki gizli alanlari decode edilemez zannetmek ekip ici paylasimda yanlis bir guven duygusu yaratir.
Payload hazirlama sirasinda mini checklist
GET /search?q=istanbul etkinlik&lang=tr
{"user":"42","filters":["active",],"meta":"eyJ0eXBlIjoiZmFzdCJ9"}- `q` parametresi encode edilmis mi?
- JSON body validate oluyor mu, sondaki virgul kaldirildi mi?
- `meta` Base64 decode edilince ne cikiyor?
- Paylasmadan once PII veya gizli alanlar maskeledi mi?
Bu use-case'te hangi araci ne zaman acarsin?
Query param encode/decode ve parser gorunumuyle request oncesi temizligi hizlandirir.
JSON syntax, format ve minify adimlarini request atmadan once kontrol eder.
Body icindeki encode parcayi veya URL-safe varyanti decode ederek ne tasidigini gosterir.
Payload icindeki epoch alanlarini okunur tarihe cevirip sure baglamini hizla netlestirir.
Sik sorulanlar
URL Encode ile tum URL mi encode edilmelidir?
Hayir. Cogu durumda yalnizca query param degeri veya ilgili URL parcasi encode edilir. Aksi halde `/`, `?`, `&` gibi separator karakterleri de donusur.
JSON Formatter neden request hazirlama akisinin ortasinda?
Cunku bozuk JSON, response tarafinda cok genel bir hata gibi gorunebilir. Request gondermeden validate edip formatlamak ayiklama suresini kisaltir.
Base64 decode edilen icerigi paylasmak guvenli mi?
Sadece hassas alanlari maskelediyseniz. Base64 geri cevrilebilir oldugu icin gizlilik yerine gecmez.
Payload hazirlama akisini simdi uygula
Query param temizligi, body validate ve encode parcasi kontrolu ayni request oncesi checklist'e donerse sonraki ticket'larda daha az deneme yanilma olur. Once URL Encode ile baslayin, sonra JSON Formatter ve Base64 ile devam edin.