Müşavir

hizli-bakis

4 uç · /api/musavir/v1/hizli-bakis

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 4 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

GET/api/musavir/v1/hizli-bakis/{kaynak}/{id}

GET — belgeyi görüntüle (görünüm + ham XML birlikte).

OturumYol parametresi: kaynakid

Ham XML de döner: görüntüleyicinin gösterdiğinden şüphelenen kullanıcı belgenin kendisine bakabilmeli. Yalnız yorumlanmış görünüm dönmek, ayrıştırıcı hatasını denetlenemez kılardı.

İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/hizli-bakis/<kaynak>/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/hizli-bakis/{kaynak}/{id}/excel

GET — belgenin kalemlerini Excel olarak indir (BLE2-8281).

OturumYol parametresi: kaynakid
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/hizli-bakis/<kaynak>/<id>/excel" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/hizli-bakis/{kaynak}/{id}/xml

GET — ham UBL indir.

OturumYol parametresi: kaynakid
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/hizli-bakis/<kaynak>/<id>/xml" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/hizli-bakis/toplu-xml

Liste rozeti için TOPLU risk.

Oturum

🔴 **POST, çünkü gövde id LİSTESİDİR.** 100 UUID bir query string'e sığmaz (≈3,7 KB) ve kenardaki WAF uzun sorguları kesebilir. Uç hiçbir şey YAZMAZ; POST burada bir taşıma kararıdır, bir mutasyon değil — bu yüzden izni de okuma iznidir. 🔴 Kapsam kapısı **HEPSİ ya da HİÇBİRİ** (hepsi_gorunur_mu): kapsam dışı id'yi sessizce elemek, ekranda rozeti eksik bir satır bırakır ve müşavir bunu "risk ölçülmedi" sanardı.

İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/hizli-bakis/toplu-xml" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?
Hâlâ takıldın mı? Destek al