Loyetta

Meta Güncelle

Aboneliğin meta nesnesini değiştirin. Aboneliği yenilemeden veya değiştirmeden hedefleme niteliklerini (ör. has_damage, plan_tier) senkronize tutmak için bunu kullanın.

POST/v1/superuser/subscriptions/meta

İstek Gövdesi

AlanTürZorunluNotlar
external_idstringEvetMevcut bir aboneliği referans almalı
metaobject | nullEvetAlan mevcut olmalı. Mevcut meta'yı tamamen değiştirir; temizlemek için null gönderin

meta birleştirilmez, değiştirilir — her zaman saklanmasını istediğiniz nesnenin tamamını gönderin. null göndermek onu temizler.

Örnek İstek

bash
curl -X POST "https://marka.prod.loyetta.com/api/v1/superuser/subscriptions/meta" \
  -H "Authorization: Bearer loy_sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "external_id": "sub_12345",
    "meta": { "plan_tier": "platinum", "has_damage": false }
  }'

Yanıt (200 OK)

json
{
  "success": true,
  "data": {
    "id": "01JQ...",
    "external_id": "sub_12345",
    "product_id": "01JQ...",
    "user_id": "01JQ...",
    "status": "active",
    "period": "monthly",
    "started_at": "2026-03-26T00:00:00.000000Z",
    "ended_at": null,
    "due_at": "2026-04-26T00:00:00.000000Z"
  }
}

Hata Yanıtları

403 — Yasak (token super_user yetkisine sahip değil)

json
{
  "message": "Operation not allowed."
}

422 — Doğrulama Hatası

json
{
  "message": "The given data was invalid.",
  "errors": {
    "meta": ["The meta field must be present."]
  }
}