CoreApiPadesMobile (v2.0)

CoreApiPadesMobile, mobil imza operatörleri (Turkcell/Vodafone/AVEA) üzerinden PAdES 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 PDF’e dönüştürme) 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/CoreApiPadesMobile/SignStepOnePadesMobileCore

SignStepOnePadesMobileCore — Mobil imzayı başlat

Mobil PAdES 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 (v2.0) altındaki uç nokta ile sorgulayabilir.

Gerekli/opsiyonel alanlar

Name
operationId
Type
uuid
Description
İmzalanacak PDF’in 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) SignatureLevelForPades (boşsa BES).
Name
signatureTurkishProfile
Type
string
Description
(Opsiyonel) P1 | P2 | P3 | P4 (profil istenmiyorsa boş geçilir).
Name
requestId
Type
string
Description
İsteğin tekil kimliği (BaseRequest).
Name
displayLanguage
Type
string
Description
Dil tercihi (BaseRequest).

Request

POST

/v2.0/CoreApiPadesMobile/SignStepOnePadesMobileCore

curl -X POST "https://apitest.onaylarim.com/v2.0/CoreApiPadesMobile/SignStepOnePadesMobileCore" \
  -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",
        "signatureTurkishProfile": "P4",
        "requestId": "aaaaaaaaaaaaaaaaaaaaa",
        "displayLanguage": "tr"
      }'

Response

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

Örnek akış (PAdES Mobile)

Dosya yükleme: CoreApiFile/UploadFile veya parça/parça: ChunkInit → ChunkUpload → ChunkComplete
(Gerekirse) CoreApiPdf/ConvertToPdfCore ile PDF’e dönüştür → dönen operationId ile devam edilir.
CoreApiPadesMobile/SignStepOnePadesMobileCore → 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.