Yeni Push Notifikasyon Paylaşımı Oluşturma

Yeni bir Push Notifikasyon paylaşımı oluşturur.

POST /v1/push_notification_campaigns/{campaign_id}/push_notification_sharings

Kimlik Doğrulama

Kimlik Doğrulama Yöntemi Token token=<API_TOKEN>

Zorunlu Header Authorization

İstek

Yol Parametreleri

Parametre	Tip	Zorunlu	Açıklama	Örnek
`campaign_id`	string (uuid)	Evet	Kampanya ID'si	`campaign_id`

Header Bilgileri

Header	Zorunlu	Açıklama	Örnek
`Content-Type`	Evet	İstek içeriğinin türü.	`application/json`
`Authorization`	Evet	Pisano API token'ı.	`Token token=<API_TOKEN>`

İstek Gövdesi

{
  "phone_numbers": [
    "<phone_number>"
  ],
  "custom_attributes": {
    "<phone_number>": {
      "name": "<name>",
      "external_id": "<external_id>",
      "email": "<email>"
    }
  },
  "built_in_responses": {
    "<phone_number>": {
      "customerDetailInfo1": "<customerDetailInfo1>",
      "customerDetailInfo2": "<customerDetailInfo2>"
    }
  }
}

İstek Gövdesi Alanları

Alan	Tip	Zorunlu	Açıklama
`phone_numbers`	array	Evet	Telefon numaraları.
`phone_numbers[]`	string		Telefon numarası.
`custom_attributes`	object	Hayır	Özel nitelikler.
`custom_attributes.<phone>.name`	string		Müşterinin adı.
`custom_attributes.<phone>.external_id`	string		Müşterinin harici tanımlayıcısı.
`custom_attributes.<phone>.email`	string		Müşterinin e-posta adresi.
`built_in_responses`	object	Hayır	Yerleşik yanıtlar.
`built_in_responses.<phone>.customerDetailInfo1`	string		Yerleşik yanıt değeri.
`built_in_responses.<phone>.customerDetailInfo2`	string		Yerleşik yanıt değeri.

İstek Örneği

cURL

cURL İstek Örneği

curl --location 'https://<pisanoEnvironment>/v1/push_notification_campaigns/<campaignID>/push_notification_sharings' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data '{
  "phone_numbers": [
    "<phone_number>"
  ],
  "custom_attributes": {
    "<phone_number>": {
      "name": "<name>",
      "external_id": "<external_id>",
      "email": "<email>"
    }
  },
  "built_in_responses": {
    "<phone_number>": {
      "customerDetailInfo1": "<customerDetailInfo1>",
      "customerDetailInfo2": "<customerDetailInfo2>"
    }
  }
}'

Yanıtlar

200 Başarılı

İşlem başarıyla gerçekleştirildi.

Yanıt Alanları

Alan	Tip	Açıklama
`status`	string	Push Notifikasyon paylaşım isteği için döndürülen işlem durumu.
`delivery_time`	string	İstek için döndürülen gönderim zamanı.
`sidekiq_job_id`	string	Arka plan görevinin tanımlayıcısı.
`correlation_id`	string	İsteği takip etmek ve ilişkilendirmek için kullanılan tanımlayıcı.

Yanıt Örneği

JSON Yanıt Örneği

{
  "status": "enqueued",
  "delivery_time": "<delivery_time>",
  "sidekiq_job_id": "<sidekiq_job_id>",
  "correlation_id": "<correlation_id>"
}

400 Hatalı İstek

Bir hata oluştu.

Hata Kodu: 13000
Hata Mesajı: An error occured.

{"error_message":"An error occured","data":"An error occured","code":13000}

401 Yetkisiz Erişim

Hatalı kimlik doğrulama anahtarı.

Hata Kodu: 13001
Hata Mesajı: Wrong authentication token.

{"error_message":"Wrong authentication token","data":"Wrong authentication token","code":13001,"errors":null}

403 Erişim Engellendi

İzin reddedildi.

Hata Kodu: 13013
Hata Mesajı: Permission denied.

{"error_message":"Permission denied","data":"Permission denied","code":13013,"errors":null}

Ek Bilgiler

İstek Sınırları

20 istek/5 sn; 40/25 sn; 80/125 sn; 160/625 sn. On-premise ortamlarındaki istek sınırı kuralları düzenlenebilir veya kaldırılabilir.

Kullanım Kısıtlamaları

En iyi uygulama olarak tek bir istekte en fazla 5.000 müşteri için işlem başlatılması önerilir.

Notlar

Pisano Kampanya Paylaşım API'leri - Push Notifikasyon - Push Notifikasyon Paylasimi