CoreApiCadesMobile (v4.0)

CoreApiCadesMobile V4, mobil imza operatörleri (Turkcell/Vodafone/AVEA) üzerinden CAdES imzalama işlemini başlatır. V2'ye kıyasla imza profilleri (P1–P4) ve tüm CAdES seviyeleri (BES, EPES, T, C, X, XL, A) desteklenir. Mobil imzada işlem tek adımda tamamlanır; ayrı bir "signStepThree" adımı yoktur.

Temel kavramlar

  • OperationId: İmzalanacak dosyayı temsil eden işlem kimliği. Önceki adımlardan (dosya yükleme) elde edilir.
  • Profiller: Türk Elektronik İmza Kullanım Profilleri (P1–P4). Profil seçimi, imza seviyesi ve revocation check davranışını belirler.
  • Auth: Tüm uç noktalar ApiKey gerektirir.
  • Zarf: Tüm yanıtlar ApiResult<T> tipindedir:
    • result: T
    • error: string (hata durumunda dolar)

Enum: SignatureLevelForCadesV4

DeğerKodAçıklama
BES1Basic Electronic Signature
EPES2Electronic Signature with Explicit Policy
T3ES-T — Zaman damgalı
C4ES-C — T + revocation referansları
X5ES-X — C + zaman damgası
XL6ES-XL — X + revocation değerleri
A7ES-A — Arşiv zaman damgalı

Enum: CadesProfileV4

DeğerKodAçıklamaGeçerli SeviyelerRevocation
None0Profil yokBES—
P11Profilsiz BESBES—
P22EPES + T, SİL (CRL)TCRL
P33EPES + XL/A, SİL (CRL)EPES, XL, ACRL
P44EPES + XL/A, ÇİSDuP (OCSP)EPES, XL, AOCSP
POST/v4/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 CoreApiFingerPrint ile sorgulayabilir.

Gerekli/opsiyonel alanlar

  • Name
    operationId
    Type
    uuid
    Description

    İmzalanacak dosyanın işlem kimliği (önceki adımdan elde edilir).

  • 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
    SignatureLevelForCadesV4
    Description

    CAdES imza seviyesi. Olası değerler: BES, EPES, T, C, X, XL, A.

  • Name
    profile
    Type
    CadesProfileV4
    Description

    İmza profili. Olası değerler: None, P1, P2, P3, P4.

  • Name
    serialOrParallel
    Type
    string?
    Description

    (Opsiyonel) SERIAL | PARALLEL. Boş geçilirse PARALLEL kabul edilir.

  • Name
    signaturePath
    Type
    string?
    Description

    (Opsiyonel) Seri imzada, üzerine imza atılacak imza yolu (ör. S0, S0:S0). Parallel imzada yok sayılır.

  • Name
    requestId
    Type
    string
    Description

    21 karakter uzunluğunda benzersiz bir string. Her istek için farklı olmalıdır.

  • Name
    displayLanguage
    Type
    string
    Description

    Dil tercihi (ör. "tr").

Request

POST
/v4/CoreApiCadesMobile/SignStepOneCadesMobileCore
curl -X POST "https://apitest.onaylarim.com/v4/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": 1,
        "profile": 0,
        "serialOrParallel": null,
        "signaturePath": null,
        "requestId": "aaaaaaaaaaaaaaaaaaaaa",
        "displayLanguage": "tr"
      }'

Response

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

Örnek akış (CAdES Mobile V4)

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

V2'den V4'e geçiş

Endpoint değişiklik özeti

AmaçV2 endpointV4 endpoint
Mobil imzayı başlatPOST /v2/CoreApiCadesMobile/SignStepOneCadesMobileCorePOST /v4/CoreApiCadesMobile/SignStepOneCadesMobileCore

V2 → V4 request alanı dönüşümleri

  • V2'de vardı, V4'te kaldırıldı
    • coordinates: V4'te bu alan kaldırılmıştır.
    • signatureTurkishProfile: Yerine profile (enum) kullanılır.
    • signatureLevel (string): V4'te sayısal enum'a dönüştürüldü.
  • V4'te yeni
    • profile: Enum tabanlı profil seçimi (None=0, P1=1, P2=2, P3=3, P4=4).
    • signatureLevel: Genişletilmiş enum (BES=1, EPES=2, T=3, C=4, X=5, XL=6, A=7).
  • Aynı kalanlar
    • operationId, phoneNumber, operator, userPrompt, citizenshipNo, serialOrParallel, signaturePath, requestId, displayLanguage

Notlar

  • URL prefix: /v2/ → /v4/ olarak güncelleyin.
  • signatureLevel: V2'de string ("BES"), V4'te integer (1). Her iki format da kabul edilir.
  • Profil: V2'de signatureTurkishProfile (string), V4'te profile (enum).

Was this page helpful?