Sign in
Photo Upload

Uploads the passport photo (FornisciFoto)

Changed on

Invoked when the state is READY_FOR_PHOTO_UPLOAD. The client supplies an Idempotency-Key identifying the user action: re-sending the same key is a safe retry, while a new key overwrites the previously associated photo.

post/image

Request

  • Base URL: https://api.your-bff.it/v1
  • URL: https://api.your-bff.it/v1/image
  • Auth: HTTP bearer

Headers

Idempotency-Keystring uuid required

Client-generated UUID identifying a single user action (intent). The same key MUST be reused when retrying the same action (e.g. after a network timeout) so the operation is replayed safely. A new key signals a new intent: replace the draft, overwrite the photo, etc. The BFF maps this client key to the per-step INPS Idempotency-Key it persists, guaranteeing the local record stays reconcilable with the INPS source of truth.

Request body

idLavorazionestring required

The INPS idLavorazione of the draft application.

fotoCEDstring byte required

Photo encoded in Base64 (max 2Mb).

informativaFotoboolean required

1=Acceptance of photo information.

Response

Photo acquired and validated. Next state returned.

state'READY_FOR_NEW_DRAFT' | 'DRAFT' | 'READY_FOR_PHOTO_UPLOAD' | 'UPLOADING_PHOTO' | 'READY_FOR_DOCUMENTS_UPLOAD' | 'UPLOADING_DOCUMENTS' | 'ACQUIRED'

Internal workflow state (managed by the BFF/DB) that guides the FE's display logic.

Changes