Müşavir

connectorlar

24 uç · /api/musavir/v1/connectorlar

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 24 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/connectorlar

Bakiye + defter.

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

Ac

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

Bir beyannamenin mükellefe görünen tam hâli.

OturumYol parametresi: id

🔴 404 mesajı "yetkiniz yok" DEMEZ ve dememeli: RLS satırı zaten elediği için başka bir müvekkilin beyannamesi ile hiç var olmayan bir id **ayırt edilemez** — ayırt edilebilseydi uç, "bu büroda şu id'de bir beyanname var mı" sorusunu cevaplayan bir sızıntı olurdu.

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

Taslağı yeniden yaz (başlık + satırların TAMAMI).

OturumYol parametresi: id

🔴 Yalnız TASLAK. Onaylı fatura resmî belgedir: düzeltilmez, **iptal edilir ya da iade faturası kesilir** (0723 · DB trigger'ıyla da zorlu). Portal o kuralı delmez. 🔴 Satırlar silinip yeniden yazılır, tek tek yamalanmaz — "başlık satırlardan TÜRETİLİR" değişmezi kısmi güncellemede kırılırdı ([crate::satis_fatura::taslak_guncelle]'nin kendi gerekçesi). Bu yüzden gövde, kesme gövdesiyle AYNI şekildedir.

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

Taslak faturayı sil (BLE2-7893). **Onaylı fatura silinmez** — iptal edilir.

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

Elle "şimdi çek" — canlı API bağlantısı.

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/connectorlar/<id>/cek" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/connectorlar/{id}/devre-disi

Devre disi

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/connectorlar/<id>/devre-disi" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/connectorlar/{id}/dosya

Dosya

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

Bakiye + defter.

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

Eşleme yaz (upsert). Hedef, müvekkilin planında ÇALIŞIR bir YAPRAK hesap olmak zorunda.

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.musavir.blesyum.app/api/musavir/v1/connectorlar/<id>/eslemeler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/musavir/v1/connectorlar/{id}/eslemeler/{tur}/{kaynak}

Taslak faturayı sil (BLE2-7893). **Onaylı fatura silinmez** — iptal edilir.

OturumYol parametresi: idturkaynak
İstek
curl -X DELETE "https://{slug}.musavir.blesyum.app/api/musavir/v1/connectorlar/<id>/eslemeler/<tur>/<kaynak>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/connectorlar/{id}/etkinlestir

Etkinlestir

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

Gunluk

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

Kimlik

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.musavir.blesyum.app/api/musavir/v1/connectorlar/<id>/kimlik" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/connectorlar/{id}/onizle

🔴 Beyanname AÇMADAN defterin ne dediğini göster.

OturumYol parametresi: id

Önizleme olmadan müşavirin tek yolu taslak açıp bakmaktı; beğenmezse silmesi gerekirdi ve by_asil_uniq yüzünden aynı dönemde ikinci bir deneme ancak silme sonrası olurdu. Bir soruyu cevaplamak için kayıt açtırmak, kaydı soru işaretine çevirir.

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

Saglik

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

Ölü mektuptan geri al.

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/connectorlar/<id>/senkron/devam" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/connectorlar/{id}/test

Test

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

Bakiye + defter.

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

POST /gizlilik/karar — **izin İSTEMEZ ve kısıt kapısının muafıdır** (bkz. durum_h).

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

Katalog — ekran alan seçicisini BUNDAN çizer, kendi listesini UYDURMAZ.

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

Bakiye + defter.

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

POST /gizlilik/karar — **izin İSTEMEZ ve kısıt kapısının muafıdır** (bkz. durum_h).

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

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/connectorlar/taslaklar/karar-toplu" \
  -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