accounts — Reklam API

GET/api/ads/v1/accounts/{id}/agent-scope

Devir ekranının listesi: kampanyalar + ajan kapsamındaki durumları (BLE2-9878).

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/accounts/<id>/agent-scope" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/ads/v1/accounts/{id}/backfill

Backfill status

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/accounts/<id>/backfill" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/ads/v1/accounts/{id}/backfill

Backfill start

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.ads.blesyum.app/api/ads/v1/accounts/<id>/backfill" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/ads/v1/accounts/{id}/backfill

Backfill cancel

OturumYol parametresi: id

İstek

curl -X DELETE "https://{slug}.ads.blesyum.app/api/ads/v1/accounts/<id>/backfill" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/ads/v1/accounts/{id}/first-look

İlk bakış raporu (BLE2-9877).

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/accounts/<id>/first-look" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/ads/v1/accounts/{id}/quality-refresh

"Şimdi yenile" — hız sınırlı (BLE2-9651).

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.ads.blesyum.app/api/ads/v1/accounts/<id>/quality-refresh" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/ads/v1/accounts/{id}/recommendations

Load

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/accounts/<id>/recommendations" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/ads/v1/accounts/{id}/reconcile-day

Bir günü kanalla mutabık kıl (BLE2-9936) — `POST /accounts/{id}/reconcile-day`.

OturumYol parametresi: id

🔴 **`POST`, ve `refetch`ten ayrı bir uç.** İkisi de günü yeniden çeker; farkları kullanıcıya verdikleri cevapta: `refetch` "düzelttim" der, bu "**ne kadar kaymıştı**" der. Aynı uca bir bayrak olarak eklenseydi, farkı görmek isteyen destek görevlisi bayrağı unutur ve düzeltmeyi ölçümsüz yapardı — kayma bir daha asla öğrenilemezdi. İzin `ads.settings`: uç günü **yeniden yazar**, salt okuma değildir.

İstek

curl -X POST "https://{slug}.ads.blesyum.app/api/ads/v1/accounts/<id>/reconcile-day" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/ads/v1/accounts/{id}/refetch

Tekil gün yeniden çekimi (BLE2-9704) — denetim defterine `diagnostic` olarak düşer.

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.ads.blesyum.app/api/ads/v1/accounts/<id>/refetch" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/ads/v1/accounts/{id}/refresh

"Şimdi yenile" — hız sınırlı (BLE2-9651).

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.ads.blesyum.app/api/ads/v1/accounts/<id>/refresh" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}