CoreApiFingerPrint (v2.0)

CoreApiFingerPrint, mobil imza başlatma adımında (CoreApiPadesMobile / CoreApiCadesMobile / CoreApiXadesMobile) üretilen parmak izi (fingerprint) değerini okumanız için kısa beklemeli bir uç nokta sağlar. İstemci bu endpoint’i çağırarak kullanıcıya gösterilecek fingerprint’i elde eder.

Temel kavramlar

OperationId: Mobil imza başlatma çağrısında üretilen/aktarılan işlem kimliği. Fingerprint bu id ile ilişkilendirilir.
Auth: Uç nokta ApiKey gerektirir.
Zarf: Yanıt ApiResult<T> tipindedir:
- result: T
- error: string (hata durumunda dolar)

POST/v2.0/CoreApiFingerPrint/GetFingerPrintCore

GetFingerPrintCore

Verilen operationId için hafızada üretilmiş fingerprint değerini döner. Değer hazır değilse kısa aralıklarla (uygulama içi bekleme) kontrol eder ve hazır olduğunda döndürür.

Gerekli alanlar

Name
operationId
Type
uuid
Description
Mobil imza akışındaki işlem kimliği.
Name
requestId
Type
string
Description
İsteğin tekil kimliği (BaseRequest).
Name
displayLanguage
Type
string
Description
Dil tercihi (BaseRequest).

Request

POST

/v2.0/CoreApiFingerPrint/GetFingerPrintCore

curl -X POST "https://apitest.onaylarim.com/v2.0/CoreApiFingerPrint/GetFingerPrintCore" \
  -H "X-API-KEY: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{ "operationId": "11111111-1111-1111-1111-111111111111", "requestId": "aaaaaaaaaaaaaaaaaaaaa", "displayLanguage": "tr" }'

Response

{
  "result": {
    "fingerPrint": "CAFEBABE1234..."
  },
  "error": null
}

Örnek akış (Mobil İmza + Fingerprint)

CoreApiPadesMobile/SignStepOnePadesMobileCore (veya Cades/Xades Mobile) ile mobil imza akışını başlatın → operationId ile devam edilir.
CoreApiFingerPrint/GetFingerPrintCore ile fingerprint değerini operationId üzerinden alın ve kullanıcıya gösterin.
İmza operatör tarafından onaylandıktan sonra işlem tamamlanır; ek bir adım gerekmez.