iOS - Utility Modülü¶

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
source 'https://github.com/CocoaPods/Specs.git'
source 'ssh://git@github.com/EnquraTechnology/EnQualifyiOSPackages.git'

target 'EnQualifyPlus-SDK' do
  # Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
  pod 'EnQualify/OCR', '2.0.4.2'
  pod 'EnQualify/Face', '2.0.4.2'
  pod 'EnQualify/NFC', '2.0.4.2'
  pod 'EnQualify/VideoCall', '2.0.4.2'
  pod 'EnQualify/Utility', '2.0.4.2'
  # Pods for EnQualifyPlus-SDK
end

import UtilityModule


class ViewController: UIViewController, EnQualifyUtilityDelegate {

    func someMethodInside() {
        EnQualifyUtility.setBaseModel(with baseModel: BaseModelUtility, delegate: Any?)
    }

    func baseModelCompleted() { }
    func initializeFailed(with key: CustomNSError) { }
    func deinitializeCompleted(moduleName: String) { }
}

// BaseModelUtility
    public var signallingCertificateList: [String]?
    public var mapiCertificateList: [String]?
    public var signallingCertificateBase64List: [String]?
    public var mapiCertificateBase64List: [String]?
    public var baseURL: String?
    public var locale: String?
    public var mobileUser: String?
    public var countryCode: String?

public static func callTypeGet(
    with handler: String?, 
    completionHandler: @escaping ([String: String]?) -> ()
)

EnQualifyCore.callTypeGet(with: "CONTEXT_ID_123") { callTypes in
    guard let callTypes = callTypes else {
        print("Çağrı tipleri alınamadı")
        return
    }

    print("Mevcut çağrı tipleri:")
    for (key, value) in callTypes {
        print("Kod: \(key) - Açıklama: \(value)")
    }
}

// Belirli bir işlem için çağrı tipleri
EnQualifyUtility.callTypeGet(with: "KYB") { callTypes in
}

// Genel kullanım için çağrı tipleri
EnQualifyUtility.callTypeGet(with: nil) { callTypes in
}

import UtilityModule

/// Identity Type: "T.C. Kimlik Kartı"
/// Identity No: "12345678901"
 EnQualifyUtility.appointmentGet(identityType: String?, identityNo: String?) { result in
 }

uId: UUID?                   // Randevunuza ait unique bir referans
callType: String?            // Randevunun hangi callType'a ait olduğu
callTypeValue: String?       // Ait olan callType'ın verification platformdaki UI ismi
identityType: String?        // Randevunun hangi kimlik tipinde olduğu
identityNo: String?          // Randevunun hangi kimlik numarasına ait olduğu
name: String?                // Randevu alan kişinin ismi
surname: String?             // Randevu alan kişinin soyismi
phone: String?               // Randevu alan kişinin telefon numarası
email: String?               // Randevu alan kişinin e-posta adresi
startDate: String?           // Randevunun hangi güne ait olduğu
endDate: String?             // Randevuya katılmak için son tarih
isPriorityCustomer: Bool?    // Randevunun önceliğini belirtir.

import UtilityModule
/// callType : "NewCustomer"
/// identityType: "T.C. Kimlik Kartı"
/// identityNo: "12345678901"
EnQualifyUtility.appointmentCancel(callType: String, identityType: String, identityNo: String ) { result in 

}

import UtilityModule
/// callType: "NewCustomer"
/// startDate: "2025-01-23T04:56:07.000+00:00"
/// endDate: "2025-01-23T04:56:07.000+00:00"
EnQualifyUtility.appointmentAvailableGet(callType: String?, startDate: String?, endDate: String?) { result in 
}

date: String?            // Randevunun hangi gün'e ait olduğu
startTime: String?       // Randevunun başlangıç saati
endTime: String?         // Randevunun bitiş saati
count: String?           // Saat aralığındaki randevu sayısı

import UtilityModule
/// callType: "NewCustomer"
/// date: "2025-05-09T00:00:00Z"
/// startTime: "14:45:00"
/// identityType: "T.C. Kimlik Kartı"
/// identityNo: "12345678901"
/// name: "Ahmet"
/// surname: "Yılmaz"
/// phone: "05993311920"
/// email: "example@enqura.com"
/// uId: "c18683b4-8c79-47ef-bd93-60f54c64e8de"
EnQualifyUtility.appointmentSave(callType: String?, date: String?, startTime: String?, identityType: String?, identityNo: String?, name: String?, surname: String?, phone: String?, email: String?, uId: UUID?) { result in 
}

EnQualifyUtility.signingSet(data: Data, reference: String? = nil) { (status: Bool) in 
}

EnQualifyUtility.signingFinish(reference: String? = nil)

public static func barcodeRead(
    content: String?, 
    isWithAddress: AnyObject?, 
    identityNo: String?, 
    completionHandler: @escaping (String?, String?, String?, Bool?) -> ()
)

import UtilityModule

EnQualifyUtilty.barcodeRead(
    content: "base64DataSample",
    isWithAddress: true,
    identityNo: "12345678901",
    completionHandler: { barcode, expireDate, address, isSameIdentity in
        guard let barcode = barcode,
              let address = address,
              let isSameIdentity = isSameIdentity,
              isSameIdentity else {
            print("Barkod okuma başarısız")
            return
        }

        print("Barkod: \(barcode)")
        print("Son Kullanma Tarihi: \(expireDate ?? "Belirtilmemiş")")
        print("Adres: \(address)")
    }
)

public static func addressVerify(
    identityNo: String, 
    barcode: String, 
    completionHandler: @escaping (Bool) -> ()
)

import UtilityModule

EnQualifyUtilty.addressVerify(
    identityNo: "12345678901",
    barcode: "barcode_string",
    completionHandler: { isVerified in
        if isVerified {
            print("Adres doğrulama başarılı")
            // Doğrulama başarılı işlemleri
        } else {
            print("Adres doğrulama başarısız")
            // Hata durumu işlemleri
        }
    }
)

public static func callBusinessCheck(
    taxNumber: String,
    reference: String? = nil,
    completionHandler: @escaping (VerifyCallBusinessCheckModelWrapper?) -> ()
)

public var checkRecord: AnyObject?      // Daha önceden kayıt var mı?
public var callBusinessUId: String?     // Bu işleme ait business ID
public var type: String?               // İşletme tipi (limited/şahıs)

import UtilityModule

EnQualifyUtility.callBusinessCheck(
    taxNumber: "1234567890",
    reference: "REF123",
    completionHandler: { result in
        guard let result = result else {
            print("İşletme kontrolü başarısız")
            return
        }

        if result.checkRecord != nil {
            print("İşletme daha önce kaydedilmiş")
            print("Business ID: \(result.callBusinessUId ?? "Belirtilmemiş")")
            print("Tip: \(result.type ?? "Belirtilmemiş")")
        } else {
            print("Yeni işletme kaydı gerekiyor")
        }
    }
)

public static func callBusinessAdd(
    taxNumber: String,
    name: String,
    shortName: String? = nil,
    data: String? = nil,
    type: String? = nil,
    reference: String? = nil,
    completionHandler: @escaping (String?) -> ()
)

import UtilityModule

EnQualifyUtility.callBusinessAdd(
    taxNumber: "1234567890",
    name: "Örnek Şirket A.Ş.",
    shortName: "Örnek Şirket",
    data: "Dashboard için ek bilgiler", // JSON şeklinde gönderilecektir.
    type: "limited",
    reference: "REF123",
    completionHandler: { businessId in
        if let businessId = businessId {
            print("İşletme başarıyla eklendi. Business ID: \(businessId)")
        } else {
            print("İşletme ekleme başarısız")
        }
    }
)

public static func callBusinessStaffAdd(
    callBusinessUID: String?,
    sessionUId: String?,
    name: String,
    surname: String,
    identityNo: String,
    birthDate: String,
    phone: String,
    completionHandler: @escaping (AnyObject?) -> ()
)

import UtilityModule

EnQualifyUtility.callBusinessStaffAdd(
    callBusinessUID: "BUSINESS_123",
    sessionUId: "SESSION_456",
    name: "Ahmet",
    surname: "Yılmaz",
    identityNo: "12345678901",
    birthDate: "1990-01-15",
    phone: "+905551234567",
    completionHandler: { result in
        if result != nil {
            print("Çalışan başarıyla eklendi")
        } else {
            print("Çalışan ekleme başarısız")
        }
    }
)

public static func callBusinessStaffCheck(
    identityNo: String,
    callBusinessUID: String?,
    completionHandler: @escaping (AnyObject?) -> ()
)

import UtilityModule

EnQualifyUtility.callBusinessStaffCheck(
    identityNo: "12345678901",
    callBusinessUID: "BUSINESS_123",
    completionHandler: { result in
        if result != nil {
            print("Çalışan mevcut")
        } else {
            print("Çalışan bulunamadı")
        }
    }
)

public static func callBusinessUpdate(
    callBusinessUID: String?,
    reference: String?,
    isInProgress: AnyObject?,
    type: String?,
    completionHandler: @escaping (AnyObject?) -> ()
)

import UtilityModule

EnQualifyUtility.callBusinessUpdate(
    callBusinessUID: "BUSINESS_123",
    reference: "REF123",
    isInProgress: true,
    type: "limited",
    completionHandler: { result in
        if result != nil {
            print("İşletme durumu güncellendi")
        } else {
            print("Güncelleme başarısız")
        }
    }
)

public static func callBusinessDocumentAdd(
    category: String?,
    reference: String?,
    callBusinessUId: String?,
    document: [VerifyMobileCallBusinessDocumentArrayWrapper]?,
    completionHandler: @escaping (AnyObject?) -> ()
)

public var extension: String?      // Dosya uzantısı (pdf, jpg, png vb.)
public var content: String?        // Dosya içeriği (Base64 formatında)
public var contentHash: String?    // Dosya hash değeri

import UtilityModule

let document = VerifyMobileCallBusinessDocumentArrayWrapper()
document.extension = "pdf"
document.content = "Base64EncodedFileContent"
document.contentHash = "SHA256HashValue"

EnQualifyUtility.callBusinessDocumentAdd(
    category: "TICARET_SICIL_GAZETESI",
    reference: "REF123",
    callBusinessUId: "BUSINESS_123",
    document: [document],
    completionHandler: { result in
        if result != nil {
            print("Doküman başarıyla yüklendi")
        } else {
            print("Doküman yükleme başarısız")
        }
    }
)

public static func getDocumentKYBCategoryList(
    completionHandler: @escaping ([VerifyInfoDocumentKYBCategoryArrayWrapper]?) -> ()
)

public var category: String?       // Kategori kodu
public var name: String?          // Kategori adı (Türkçe)
public var nameEn: String?        // Kategori adı (İngilizce)
public var isRequired: AnyObject? // Zorunlu mu?
public var sequence: NSNumber?    // Sıralama
public var secondPhase: AnyObject? // İkinci fazda mı gerekli?

import UtilityModule

EnQualifyUtility.getDocumentKYBCategoryList { categories in
    guard let categories = categories else {
        print("Kategori listesi alınamadı")
        return
    }

    for category in categories {
        print("Kategori: \(category.category ?? "Belirtilmemiş")")
        print("Ad: \(category.name ?? "Belirtilmemiş")")
        print("Zorunlu: \(category.isRequired ?? false)")
        print("---")
    }
}

EnQualifyUtility.conversationalValidationLaunch(
    baseModel: baseModel,
    sessionModel: sessionModel,
    delegate: self
)

// Delegate callback — sorular bu metod ile gelir
func conversationalValidationConfigGetCompleted(
    config: [VerifyVoiceVerificationMobileListWrapper]?
) {
    // config içinde sorular, içerik tipleri,
    // displayCount, isRandom ve expectedAnswers bulunur
}

EnQualifyUtility.callVoiceVerificationAdd(
    videoContentURL: videoFileURL,       // Kameradan kaydedilen mp4
    soundContentURL: audioFileURL,       // Mikrofondan kaydedilen m4a
    voiceVerificationContentUId: contentUId  // Hangi soruya ait olduğu
) { response in
    let answer = response?.answer ?? ""
    // answer dolu   → STT başarılı, bir sonraki soruya geç
    // answer boş    → STT başarısız, kullanıcıya hata göster
    // response nil  → teknik hata
}

EnQualifyUtility.callVoiceVerificationApproved { isApproved in
    if isApproved {
        // Doğrulama başarılı → sonraki adıma geç
    } else {
        // Doğrulama başarısız → kullanıcıya hata göster
    }
}

conversationalValidationLaunch()
        ↓
conversationalValidationConfigGetCompleted (delegate)
        ↓
[ Her soru için ]
callVoiceVerificationAdd(video, ses, contentUId)
        ↓  response.answer
[ Tüm sorular bitti ]
        ↓
callVoiceVerificationApproved()
        ↓  true / false