Kişiselleştirilmiş Bağlantı Paylaşım URL'si Oluşturma

Üçüncü taraf bir sistem aracılığıyla iletilebilecek, müşteriye özel bir anket bağlantısı oluşturur.

POST /external/v1/link_sharings/{link_channel_id}/generate_link

Kimlik Doğrulama

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

İstek

Yol Parametreleri

Parametre	Tip	Zorunlu	Açıklama	Örnek
`link_channel_id`	string	Evet	Bağlantı kanalının ID'si.	`<link_channel_id>`

Header Bilgileri

Header	Zorunlu	Açıklama	Örnek
`Accept`	Hayır	Beklenen yanıt formatını belirtir.	`application/json`
`Content-Type`	Evet	İstek içeriğinin türünü belirtir.	`application/json`
`Authorization`	Evet	Pisano API token'ı.	`Token token=<TOKEN>`

İstek Gövdesi

{
  "customer": {
    "email": "<email>",
    "external_id": "<external_id>"
  },
  "built_in_responses": {
    "Segment": "<Segment>",
    "Location": "<Location>",
    "TransactionDate": "<TransactionDate>"
  },
  "options": {
    "shorten_url": true
  }
}

İstek Gövdesi Alanları

Alan	Tip	Zorunlu	Açıklama	Örnek
`link_channel_id`	string	Evet	Bağlantı kanalının ID'si.	`<link_channel_id>`
`customer`	object	Evet	Müşteriye özel alanları içerir.	`{}`
`customer.email`	string	Hayır	Müşterinin e-posta adresi.	`<email>`
`customer.phone_number`	string	Hayır	Müşterinin telefon numarası.	`<phone_number>`
`customer.name`	string	Hayır	Müşterinin adı.	`<name>`
`customer.external_id`	string	Hayır	Müşterinin harici tanımlayıcısı.	`<external_id>`
`built_in_responses`	object	Hayır	Anket URL'sine eklenen geri bildirimle ilişkili değerleri içerir.	`{}`
`options`	object	Hayır	Bağlantı oluşturma seçeneklerini içerir.	`{}`
`options.shorten_url`	boolean	Hayır	true olarak ayarlandığında kısaltılmış bir bağlantı döndürür.	`true`

İstek Örneği

cURL

cURL İstek Örneği

curl --location 'https://<pisanoURL>/external/v1/link_sharings/<link_channel_id>/generate_link' \
--header 'Accept: application/json' \
--header 'Authorization: Token token=<TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
  "customer": {
    "email": "<email>",
    "external_id": "<external_id>"
  },
  "built_in_responses": {
    "Segment": "<Segment>",
    "Location": "<Location>",
    "TransactionDate": "<TransactionDate>"
  },
  "options": {
    "shorten_url": true
  }
}'

Yanıtlar

201 Oluşturuldu

Yanıt Şeması

Şema

└── link string

Yanıt Alanları

Alan	Tip	Zorunlu	Açıklama	Örnek
`link`	string		Oluşturulan kişiselleştirilmiş anket bağlantısı.	`https://psn.vc/<short_code>`

Yanıt Örneği

JSON 201 Yanıt Örneği

{
  "link": "https://psn.vc/<short_code>"
}

Hata Yanıtları

400 Hatalı İstek

Hatalı istek

Hata Kodu: 13000
Hata Mesajı: Bir hata oluştu

401 Yetkisiz Erişim

Yetkisiz erişim

Hata Kodu: 13001
Hata Mesajı: Hatalı kimlik doğrulama anahtarı

404 Bulunamadı

İstenen kaynak bulunamadı

Hata Kodu: 13002
Hata Mesajı: İstenen kaynak bulunamadı

Ek Bilgiler

İstek Sınırları

8 saniyede 20 istek yapılabilir. On-premise ortamlarda istek sınırları artırılabilir veya kaldırılabilir. Bu sınırlar IP adresine göre yapılandırılabilir.

Kullanım Kısıtlamaları

Kişiselleştirilmiş bağlantılar için Pisano, müşteri başına bir istek yapılmasını öngörür. Önceden oluşturulmuş ve bir akış atanmış bir Link Channel bulunmalıdır.

Pisano Harici API - Bağlantı Paylaşımı - Kişiselleştirilmiş Bağlantı Paylaşım Linki Oluşturma