CSV ile Müşteri Aktarımı

CSV içeriğindeki müşteri verilerini toplu olarak Pisano Müşteri Şeması'nda tanımlanan alanlara aktarır.

POST /v1/customers/import_from_csv

Kimlik Doğrulama

Kimlik Doğrulama Yöntemi Authorization header üzerinden Bearer token

Header Bilgileri

Header	Zorunlu	Açıklama	Örnek
`Authorization`	Evet	Kimlik doğrulaması için kullanılan Bearer token.	`Bearer <token>`
`Content-Type`	Evet	İstek içeriğinin türü.	`application/json`

İstek Gövdesi

CSV içeriği, JSON istek gövdesinde csv_file.csv_string alanı üzerinden gönderilir. Bu endpoint, multipart dosya yükleme yöntemini kullanmaz.

{
  "node_id": "<node_id>",
  "column_mapping": {
    "phone_number": "<csv_phone_column>",
    "external_id": "<csv_external_id_column>",
    "email": "<csv_email_column>",
    "name": "<csv_name_column>"
  },
  "csv_file": {
    "name": "<csv_file_name>",
    "csv_string": "<csv_content_with_headers_and_customer_rows>"
  }
}

İstek Gövdesi Alanları

Alan	Tip	Zorunlu	Açıklama
`node_id`	string	Evet	Pisano hesap/birim tanımlayıcısı.
`column_mapping`	object		Pisano müşteri şeması kodlarını CSV sütun adlarıyla eşleştirir.
`csv_file`	object		CSV dosyasına ait bilgiler.
`csv_file.name`	string		CSV dosyasının adı.
`csv_file.csv_string`	string		CSV içeriği. İlk satır sütun başlıklarını, sonraki satırlar ise müşteri verilerini içerir.

İstek Örneği

cURL

cURL İstek Örneği

curl --location 'https://<pisano_domain>/v1/customers/import_from_csv' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "node_id": "<node_id>",
  "column_mapping": {
    "phone_number": "<csv_phone_column>",
    "external_id": "<csv_external_id_column>",
    "email": "<csv_email_column>",
    "name": "<csv_name_column>"
  },
  "csv_file": {
    "name": "<csv_file_name>",
    "csv_string": "<csv_content_with_headers_and_customer_rows>"
  }
}'

Yanıtlar

200 Başarılı

CSV içeriği başarıyla işlendi. Yanıt gövdesi boş bir JSON nesnesidir.

Yanıt Örneği

{}

Hata Yanıtları

400 Hatalı İstek

Geçersiz veya eksik istek verisi.

401 Yetkisiz Erişim

Geçersiz veya eksik kimlik doğrulama anahtarı.

Ek Bilgiler

Kullanım Kısıtlamaları

İstek gövdesi ve column_mapping yapılandırması, hedef hesaba ve doldurulması gereken Müşteri Şeması alanlarına bağlıdır.

Pisano Harici API - Müşteriler - Müşterileri CSV Dosyasından İçe Aktar