5. Güncelleme
Mevcut bir cüzdan sahibi kaydını güncellemek için bu sayfadaki servis, gerekli parametrelerle birlikte kullanılmalıdır.
Cüzdan Sahibi Bilgilerini Güncelle
PUT {{WalletUrl}}/api/v1/walletowner
Not: Bu servisi çağırmadan önce, apikeypublic ve apiclientpublic parametrelerini Header kısmına eklemeniz gereklidir.
Servise gönderilmesi gereken parametreler şu şekildedir:
Zorunlu header parametreleri
apikeypublic
string
Evet
API erişimi sırasında kimlik doğrulaması sağlamak amacıyla gönderilen genel anahtardır. Güvenlik kontrolü bu değer üzerinden yapılır.
apiclientpublic
string
Evet
İstek yapan uygulamayı tanımlayan istemci anahtarıdır. API çağrılarının yetkilendirilmesinde kullanılır.
İstek gövdesi parametreleri
Id
guid
Evet
Cüzdan sahibine sistem tarafından atanan benzersiz tanımlayıcı (UUID) değerdir. Veri bütünlüğünü sağlamak amacıyla kullanılır.
FullName
string
Hayır
Cüzdan sahibinin ad ve soyad bilgisini bir arada tutar. Kimlik bilgisi olarak gösterimlerde yer alır.
string
Hayır
Kullanıcının kayıtlı e-posta adresidir. Bildirimler, uyarılar ve iletişim kanalları bu adres üzerinden yürütülür.
PhoneNumber
string
Evet
Kullanıcıya ait telefon numarası bilgisidir. Gerekli durumlarda doğrulama süreçlerinde işleme alınır.
Address
string
Hayır
Kullanıcının kayıt sırasında sağladığı adres bilgisidir. Lojistik ve yerelleştirme ihtiyaçlarında kullanıma açıktır.
Country
string
Hayır
Cüzdan sahibinin ülke konumunu ifade eder. Bölgesel kısıtlamalarda ve kampanya hedeflemelerinde baz alınır.
City
string
Hayır
Adresin şehir bilgisidir. Bölge bazlı filtrelemelerde kullanılabilir.
DateOfBirth
Date
Hayır
Kullanıcının doğum tarihini belirtir. Gerçek kişilere özel kayıt sürecinin parçasıdır.
CompanyName
string
Hayır
Tüzel kullanıcılar için geçerli olan firma adını belirtir. Şirket bazlı işlemlerde görüntülenir.
{
"Id": "0000-0000-0000-0000-0000",
"Fullname": "{{$randomFullName}}",
"Email": "{{$randomEmail}}",
"PhoneNumber": "+905343664455",
"Address": "{{$randomStreetAddress}}",
"Country": "{{$randomCountry}}",
"City": "{{$randomCity}}",
"DateOfBirth": "2001-03-03",
"CompanyName": "{{$randomCompanyName}}"
}Servisten dönen parametreler şu şekildedir:
Parametreler ve açıklamaları
IsFailure
bool
Servis yanıtında bir hata olup olmadığını belirtir. true olması, işlemin hatalı sonuçlandığını gösterir. Değerlendirme yapılırken dikkate alınmalıdır.
IsSuccess
bool
İşlemin beklenildiği şekilde tamamlanıp tamamlanmadığını bildirir. true değeri başarılı yürütmeyi işaret eder. Sonuç kontrolünde referans alınır.
Errors
Array
Servis çağrısı sırasında oluşan hata bilgilerini içerir. Hatalar çoğunlukla hata kodu ve açıklama ile birlikte sunulur. Sorun tespitinde kullanılır.
Value
Array<Items>
Servisin döndürdüğü temel veri içeriğini temsil eder. Sonuçlar bu alan üzerinden kullanıcıya aktarılır. Dönüş tipi yapılan işleme göre değişkenlik gösterebilir.
Value > Id
Guid
Cüzdan sahibine sistem tarafından atanan benzersiz tanımlayıcı (UUID) değerdir. Veri bütünlüğünü sağlamak amacıyla kullanılır.
Value > Fullname
string
Kullanıcının ad ve soyad bilgisini içeren metinsel ifadedir. Kimlik doğrulama ve temsil amaçlı kullanılır.
Value > Email
string
Kullanıcının sistemde tanımlı e-posta adresidir. Bildirim, yetkilendirme ve iletişim işlemlerinde referans alınır.
Value > PhoneNumber
string
Cüzdan sahibine ait GSM numarasıdır. Doğrulama kodları ve iki faktörlü kimlik doğrulama süreçlerinde kullanılır.
Value > TaxNumber
string
Kurumsal kullanıcılar için geçerli olan Vergi Kimlik Numarası’dır (VKN). Vergisel yükümlülüklerde sistemsel kontrol sağlar.
Value > IdentityNumber
string
Gerçek kişilere özel tanımlanan kimlik numarasıdır.
Value > OwnerType
string
Cüzdan sahibinin bireysel veya kurumsal olduğunu belirten alandır.1 = Individual, 2 = Corporate
Value > CompanyName
string
Tüzel kullanıcılar için kayıtlı ticari unvandır. Fatura, işlem geçmişi ve kullanıcı arayüzü gösterimlerinde kullanılır.
Value > Address
string
Kullanıcının sistemde kayıtlı tam adres bilgisidir. Kurye, belge gönderimi ve faturalama işlemleriyle ilişkilidir.
Value > Country
string
Kullanıcının bulunduğu ülkenin ISO 3166-1 alpha-2 formatındaki ülke kodudur. Lokasyon bazlı servis kısıtlarında kullanılır.
Value > City
string
Kullanıcının adresine ait şehir bilgisidir. Bölgesel ayrım ve analizlerde referans alınır.
Value > DateOfBirth
Date
Gerçek kişi kullanıcılar için geçerli doğum tarihidir. Format: YYYY-MM-DD. Yaş sınırlı işlemlerde doğrulama kriteridir.
Value > CreatedAt
DateTime
İlgili kaydın sistem üzerinde ilk oluşturulduğu tarih-saat bilgisidir. Zaman damgası (timestamp) formatında tutulur.
Value > UpdatedAt
DateTime
En son yapılan güncellemeye ait zaman bilgisidir. Değişiklik takibi ve senkronizasyon işlemlerinde kullanılır.
Value > ExternalId
string
Kendi sisteminizdeki kullanıcıya ait benzersiz tanımlayıcı
Last updated