Kişiye Ait Pazarlama İzinleri Güncelleme

Daha önce dijiizin.com veya Dijiizin API üzerinden kaydettiğiniz kişilerin izinlerini toplu ve tekil olarak güncellemek için aşağıdaki metodları kullanabilirsiniz.

Tekil İzin Güncelleme

Toplu İzin Güncelleme

Tekil İzin Güncelleme

Endpoint URL

GET

https://api.dijiizin.com/api/V3/person/{uuid}/consent/{type}/update/{status}

Açıklama

Bu metod, belirtilen UUID'ye sahip bir kişinin belirtilen türdeki izin durumunu günceller. Eğer işlem başarılı bir şekilde tamamlanırsa, güncellenen izin türü ve yeni durumu ile birlikte bir yanıt döner. İşlem başarısız olursa, hata kodu ve mesajı içeren bir hata yanıtı döner.

Parametreler

Name
uuid
Required State
zorunlu
Format
string
Description
İlgili kişinin eşsiz tanımlayıcısıdır. Başarılı izin alma işlemleri sonrasında döndürülür. (UUID) olarak kullanılır.
Name
type
Required State
zorunlu
Format
string
Description
Güncellenmek istenen izin türünü belirtir. Bu parametre, isteğin URL'sinde yer alır ve izin güncelleme işleminin hangi tür izin üzerinde yapılacağını belirler. Zorunlu değerler: EPOSTA, MESAJ, ARAMA
Name
status
Required State
zorunlu
Format
string
Description
Bu parametre izin durumunu belirtir. Kabul edilebilir değerler Zorunlu değerler: ONAY, RET

Authorization

   Authentication: Bearer <jeton>

Not

422 ile dönen hata içerisinde message içerisinde H174 ile başlayan kod dönüyor ise RET durumundaki bir izni RET olarak güncelleme çalışmıssınız demektir. Bu hata kodunu dikkate almayınız. İzin durumu zaten RET durumundadır.
ONAY durumundaki bir izin tekrar ONAY durumudna güncellenebilir.

Örnek Request

GET

https://api.dijiizin.com/api/V3/person/{uuid}/consent/{type}/update/{status}

Örnek Response

{
    "type": "MESAJ",
    "status": "başarılı",
    "message": "Kişi MESAJ izni ONAY durumunda güncellendi."
}

Toplu İzin Güncelleme

Endpoint URL

POST

https://api.dijiizin.com/api/V3/person/{uuid}/consents/update

Açıklama

Bu metod, belirtilen UUID'ye sahip bir kişinin belirtilen türdeki izin durumunu toplu şekilde günceller. Eğer işlem başarılı bir şekilde tamamlanırsa, güncellenen izin türü ve yeni durumu ile birlikte bir yanıt döner. İşlem başarısız olursa, hata kodu ve mesajı içeren bir hata yanıtı döner.

Parametreler

Name
uuid
Required State
zorunlu
Format
string
Description
İlgili kişinin eşsiz tanımlayıcısıdır. Başarılı izin alma işlemleri sonrasında döndürülür. (UUID) olarak kullanılır. Parametre istek adresi içerisinde bulunmalıdır.
Name
contactConsent
Required State
zorunlu
Format
string
Description
Toplu güncelleme işleminde kullanılır ve bir dizi içinde birden fazla izin güncelleme bilgisini içerir. Her bir izin güncelleme bilgisi, izin türü (type), yeni izin durumu (status) içerir.
Name
type
Required State
zorunlu
Format
string
Description
Güncellenmek istenen izin türünü belirtir. Bu parametre, isteğin URL'sinde yer alır ve izin güncelleme işleminin hangi tür izin üzerinde yapılacağını belirler. Zorunlu değerler: EPOSTA, MESAJ, ARAMA
Name
status
Required State
zorunlu
Format
string
Description
Bu parametre izin durumunu belirtir. Kabul edilebilir değerler Zorunlu değerler: ONAY, RET

Authorization

   Authentication: Bearer <jeton>

Not

422 ile dönen hata içerisinde message içerisinde H174 ile başlayan kod dönüyor ise RET durumundaki bir izni RET olarak güncelleme çalışmıssınız demektir. Bu hata kodunu dikkate almayınız. İzin durumu zaten RET durumundadır.
ONAY durumundaki bir izin tekrar ONAY durumudna güncellenebilir.

Örnek İstek Gövdesi

POST

https://api.dijiizin.com/api/V3/person/{uuid}/consents/update/

{
   "contactConsents": [
       {
           "type": "MESAJ",
           "status": "ONAY"
       },
       {
           "type": "ARAMA",
           "status": "ONAY"
       },
       {
           "type": "EPOSTA",
           "status": "ONAY"
       }
   ]
}

Örnek Response

[
    {
        "type": "MESAJ",
        "status": "başarılı",
        "message": "Kişi MESAJ izni ONAY durumunda güncellendi."
    },
    {
        "type": "ARAMA",
        "status": "başarılı",
        "message": "Kişi ARAMA izni ONAY durumunda güncellendi."
    },
    {
        "type": "EPOSTA",
        "status": "başarılı",
        "message": "Kişi EPOSTA izni ONAY durumunda güncellendi."
    }
]