CoreApiCadesMobile (v2.0)

CoreApiCadesMobile, mobil imza operatörleri (Turkcell/Vodafone/AVEA) üzerinden CAdES imzalama başlatmayı sağlar. Bu adımda son kullanıcıya SMS/onay akışı gösterilir, parmak izi (fingerprint) üretilir ve işlem bir OperationId üzerinde sürdürülür.

Not: Mobil imzada işlem, operatör onayı sonrası SignStepOne çağrısından sonra tamamlanır; ayrı bir “signStepThree” adımı yoktur.

Temel kavramlar

OperationId: İmzalanacak dosyayı temsil eden işlem kimliği. Önceki adımlardan (ör. yükleme veya önimzalama) alınır.
Auth: Tüm uç noktalar ApiKey gerektirir.
Zarf: Tüm yanıtlar ApiResult<T> tipindedir:
- result: T
- error: string (hata durumunda dolar)

POST/v2.0/CoreApiCadesMobile/SignStepOneCadesMobileCore

SignStepOneCadesMobileCore — Mobil imzayı başlat

Mobil imza işlemini başlatır. İşlem sırasında operatör ile iletişim kurulur ve parmak izi (fingerprint) üretilir. İstemci bu fingerprint’i ayrı bir uç nokta olan CoreApiFingerPrint ile sorgulayabilir.

Gerekli/opsiyonel alanlar

Name
operationId
Type
uuid
Description
İmzalanacak dosyanın işlem kimliği (önceki adımdan elde edilir).
Name
coordinates
Type
object
Description
(Opsiyonel) Konum bilgileri (şu an kullanılmıyor).
Name
phoneNumber
Type
string
Description
Mobil imza telefon numarası (örn. 5XXXXXXXXX).
Name
operator
Type
string
Description
Operatör adı (TURKCELL | VODAFONE | AVEA).
Name
userPrompt
Type
string
Description
Kullanıcıya gösterilecek mesaj.
Name
citizenshipNo
Type
string
Description
(Opsiyonel) İmza sahibinin TCKN doğrulaması için.
Name
signatureLevel
Type
string
Description
(Opsiyonel) SignatureLevelForCades (boşsa BES).
Name
signaturePath
Type
string
Description
(Opsiyonel) Seri imzada, üzerine imza atılacak imza yolu (ör. S0:S0).
Name
signatureTurkishProfile
Type
string
Description
(Opsiyonel) P1 | P2 | P3 | P4 (profil istenmiyorsa boş geçilir).
Name
serialOrParallel
Type
string
Description
(Opsiyonel) SERIAL | PARALLEL. Boş geçilirse PARALLEL kabul edilir.
Name
requestId
Type
string
Description
İsteğin tekil kimliği (BaseRequest).
Name
displayLanguage
Type
string
Description
Dil tercihi (BaseRequest).

Request

POST

/v2.0/CoreApiCadesMobile/SignStepOneCadesMobileCore

curl -X POST "https://apitest.onaylarim.com/v2.0/CoreApiCadesMobile/SignStepOneCadesMobileCore" \
  -H "X-API-KEY: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
        "operationId": "11111111-1111-1111-1111-111111111111",
        "phoneNumber": "5XXXXXXXXX",
        "operator": "TURKCELL",
        "userPrompt": "İmzalamayı onaylıyor musunuz?",
        "citizenshipNo": null,
        "signatureLevel": "BES",
        "signaturePath": null,
        "serialOrParallel": "SERIAL",
        "signatureTurkishProfile": "P4",
        "requestId": "aaaaaaaaaaaaaaaaaaaaa",
        "displayLanguage": "tr"
      }'

Response

{
  "result": {
    "isSuccess": true,
    "operationId": "22222222-2222-2222-2222-222222222222"
  },
  "error": null
}

Örnek akış (CAdES Mobile)

Dosya yükleme: CoreApiFile/UploadFile veya parça/parça: ChunkInit → ChunkUpload → ChunkComplete
CoreApiCadesMobile/SignStepOneCadesMobileCore → mobil operatör akışı başlatılır, fingerprint üretilir (yeni operationId gelebilir).
(Opsiyonel) CoreApiFingerPrint/GetFingerPrintCore ile operationId üzerinden fingerprint alınır ve kullanıcıya gösterilir.
Operatör onayı sonrası imzalama tamamlanır; ek bir adım gerekmez. *** End Patch ***!