openapi: 3.2.0 info: title: Pagopa Citizen operation API version: 1.0.6-SNAPSHOT contact: name: PagoPA S.p.A. email: cstar@pagopa.it description: 'Operations tagged Citizen operation across 2 of this provider''s published API definitions: mdc-emd-citizen.yml, pagopa-mdc-citizen-consent-openapi.yml. Each path carries the servers of the definition it was published in.' servers: - description: Development Test url: https://api-emd.dev.cstar.pagopa.it/emd/mil/citizen x-internal: true - description: User Acceptance Test url: https://api-emd.uat.cstar.pagopa.it/emd/mil/citizen x-internal: true - description: Prod url: https://api-emd.cstar.pagopa.it/emd/mil/citizen x-internal: false tags: - name: Citizen operation description: 'ENG: TPP integration - Citizen consent operations IT: Integrazione TPP - Operazioni sui consensi del cittadino' paths: /{fiscalCode}/{tppId}: post: tags: - Citizen operation summary: 'ENG: Save citizen consent information - IT: Salvataggio dei consensi del…' operationId: saveCitizenConsent description: Save citizen consents security: - oAuth2: [] parameters: - name: Accept-Language in: header description: 'ENG: Language - IT: Lingua' schema: type: string pattern: ^[ -~]{2,5}$ minLength: 2 maxLength: 5 example: it-IT default: it-IT required: true - name: fiscalCode in: path description: 'ENG: Fiscal code of the citizen - IT: codice fiscale del cittadino' required: true schema: type: string description: Fiscal Code or P.IVA of the citizen pattern: ^[A-Za-z0-9]{11,16}$ minLength: 11 maxLength: 16 example: RSSMRO92S18L048H - name: tppId in: path description: 'ENG: Unique ID that identify TPP on PagoPA systems - IT: Identificativo univoco della TPP sui sistemi PagoPA' required: true schema: type: string description: Unique ID that identify TPP on PagoPA systems pattern: ^[ -~]{1,50}$ minLength: 1 maxLength: 50 example: 0e3bee29-8753-447c-b0da-1f7965558ec2-1706867960900 responses: '200': description: Ok content: application/json: schema: $ref: '#/components/schemas/CitizenConsentResponseDTO' examples: example1: $ref: '#/components/examples/example1' headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: BAD_REQUEST message: Something went wrong handling the request headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '401': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: CITIZEN_CONSENT_AUTHENTICATION_FAILED message: Something went wrong with authentication headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '404': description: The citizen consent was not found content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: CITIZEN_NOT_ONBOARDED message: Citizen consent not inserted headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '429': description: Too many Request content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: TOO_MANY_REQUESTS message: Too many requests headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '500': description: Server ERROR content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: GENERIC_ERROR message: Application error headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' get: tags: - Citizen operation summary: 'ENG: Returns the Citizen consent detail from fiscalCode and tppId associated…' operationId: getCitizenConsentStatus description: Get citizen consent from fiscalCode and tppId security: - oAuth2: [] parameters: - name: Accept-Language in: header description: 'ENG: Language - IT: Lingua' schema: type: string pattern: ^[ -~]{2,5}$ minLength: 2 maxLength: 5 example: it-IT default: it-IT required: true - name: fiscalCode in: path description: 'ENG: Fiscal code of the citizen - IT: codice fiscale del cittadino' required: true schema: type: string description: Fiscal Code or P.IVA of the citizen pattern: ^[A-Za-z0-9]{11,16}$ minLength: 11 maxLength: 16 example: RSSMRO92S18L048H - name: tppId in: path description: 'ENG: Unique ID that identify TPP on PagoPA systems - IT: Identificativo univoco della TPP sui sistemi PagoPA' required: true schema: type: string description: Unique ID that identify TPP on PagoPA systems pattern: ^[ -~]{1,50}$ minLength: 1 maxLength: 50 example: 0e3bee29-8753-447c-b0da-1f7965558ec2-1706867960900 responses: '200': description: Ok content: application/json: schema: $ref: '#/components/schemas/CitizenConsentResponseDTO' examples: example1: $ref: '#/components/examples/example1' headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: BAD_REQUEST message: Something went wrong handling the request headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '401': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: CITIZEN_CONSENT_AUTHENTICATION_FAILED message: Something went wrong with authentication headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '404': description: The citizen consent was not found content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: CITIZEN_NOT_ONBOARDED message: Citizen consent not inserted headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '429': description: Too many Request content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: TOO_MANY_REQUESTS message: Too many requests headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '500': description: Server ERROR content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: GENERIC_ERROR message: Application error headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' put: tags: - Citizen operation summary: 'ENG: Update citizen consent state (if tppState is true it becomes false and…' operationId: stateSwitch description: Update citizen consents security: - oAuth2: [] parameters: - name: Accept-Language in: header description: 'ENG: Language - IT: Lingua' schema: type: string pattern: ^[ -~]{2,5}$ minLength: 2 maxLength: 5 example: it-IT default: it-IT required: true - name: fiscalCode in: path description: 'ENG: Fiscal code of the citizen - IT: codice fiscale del cittadino' required: true schema: type: string description: Fiscal Code or P.IVA of the citizen pattern: ^[A-Za-z0-9]{11,16}$ minLength: 11 maxLength: 16 example: RSSMRO92S18L048H - name: tppId in: path description: 'ENG: Unique ID that identify TPP on PagoPA systems - IT: Identificativo univoco della TPP sui sistemi PagoPA' required: true schema: type: string description: Unique ID that identify TPP on PagoPA systems pattern: ^[ -~]{1,50}$ minLength: 1 maxLength: 50 example: 0e3bee29-8753-447c-b0da-1f7965558ec2-1706867960900 responses: '200': description: Ok content: application/json: schema: $ref: '#/components/schemas/CitizenConsentResponseDTO' examples: example2: $ref: '#/components/examples/example2' headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: BAD_REQUEST message: Something went wrong handling the request headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '401': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: CITIZEN_CONSENT_AUTHENTICATION_FAILED message: Something went wrong with authentication headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '404': description: The citizen consent was not found content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: CITIZEN_NOT_ONBOARDED message: Citizen consent not inserted headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '429': description: Too many Request content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: TOO_MANY_REQUESTS message: Too many requests headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '500': description: Server ERROR content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: GENERIC_ERROR message: Application error headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' servers: - description: Development Test url: https://api-emd.dev.cstar.pagopa.it/emd/mil/citizen x-internal: true - description: User Acceptance Test url: https://api-emd.uat.cstar.pagopa.it/emd/mil/citizen x-internal: true - description: Prod url: https://api-emd.cstar.pagopa.it/emd/mil/citizen x-internal: false /{tppId}: get: tags: - Citizen operation summary: 'ENG: Returns the list of Citizen Consent with TPP consent enabled - IT: Ritorna…' operationId: getCitizenEnabled description: Get citizen consent from tppId security: - oAuth2: [] parameters: - name: Accept-Language in: header description: 'ENG: Language - IT: Lingua' schema: type: string pattern: ^[ -~]{2,5}$ minLength: 2 maxLength: 5 example: it-IT default: it-IT required: true - name: tppId in: path description: 'ENG: Unique ID that identify TPP on PagoPA systems - IT: Identificativo univoco della TPP sui sistemi PagoPA' required: true schema: type: string description: Unique ID that identify TPP on PagoPA systems pattern: ^[ -~]{1,50}$ minLength: 1 maxLength: 50 example: 0e3bee29-8753-447c-b0da-1f7965558ec2-1706867960900 responses: '200': description: Ok content: application/json: schema: $ref: '#/components/schemas/ListCitizenConsentResponseDTO' example: - fiscalCode: RSSMRO92S18L048H consents: 0e3bee29-8753-447c-b0da-1f7965558ec2-1706867960900: tppState: true tcDate: '2024-11-06T11:25:40.695Z' - fiscalCode: VNTCCN92S18L048H consents: 0e3bee29-8753-447c-b0da-1f7965558ec2-1706867960900: tppState: true tcDate: '2024-11-12T11:27:23.699Z' headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: BAD_REQUEST message: Something went wrong handling the request headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '401': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: CITIZEN_CONSENT_AUTHENTICATION_FAILED message: Something went wrong with authentication headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '404': description: The citizen consent was not found content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: CITIZEN_NOT_ONBOARDED message: Citizen consent not inserted headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '429': description: Too many Request content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: TOO_MANY_REQUESTS message: Too many requests headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' '500': description: Server ERROR content: application/json: schema: $ref: '#/components/schemas/CitizenConsentErrorDTO' example: code: GENERIC_ERROR message: Application error headers: Access-Control-Allow-Origin: description: Indicates whether the response can be shared with requesting code from the given origin required: false schema: $ref: '#/components/schemas/AccessControlAllowOrigin' RateLimit-Limit: description: The number of allowed requests in the current period required: false schema: $ref: '#/components/schemas/RateLimitLimit' RateLimit-Reset: description: The number of seconds left in the current period required: false schema: $ref: '#/components/schemas/RateLimitReset' Retry-After: description: The number of seconds to wait before allowing a follow-up request required: false schema: $ref: '#/components/schemas/RetryAfter' servers: - description: Development Test url: https://api-emd.dev.cstar.pagopa.it/emd/mil/citizen x-internal: true - description: User Acceptance Test url: https://api-emd.uat.cstar.pagopa.it/emd/mil/citizen x-internal: true - description: Prod url: https://api-emd.cstar.pagopa.it/emd/mil/citizen x-internal: false components: schemas: CitizenConsentErrorDTO: type: object required: - code - message properties: code: type: string enum: - BAD_REQUEST - CITIZEN_NOT_ONBOARDED - TOO_MANY_REQUESTS - GENERIC_ERROR - TPP_NOT_FOUND - CITIZEN_CONSENT_AUTHENTICATION_FAILED description: "\"ENG: Error code: BAD_REQUEST: Something went wrong handling the request,\n CITIZEN_NOT_ONBOARDED: Citizen consent not inserted,\n TOO_MANY_REQUESTS: Too many requests,\n GENERIC_ERROR: Application Error,\n TPP_NOT_FOUND: TPP does not exist or is not active,\n CITIZEN_CONSENT_AUTHENTICATION_FAILED: Something went wrong with authentication -\n IT: Codice di errore:\n BAD_REQUEST: Qualcosa è andato storto durante\n l'invio della richiesta,\n CITIZEN_NOT_ONBOARDED: Consensi del cittadino non inseriti,\n TOO_MANY_REQUESTS: Troppe richieste,\n GENERIC_ERROR: Errore generico,\n TPP_NOT_FOUND: La TPP non esiste o non è attiva,\n CITIZEN_CONSENT_AUTHENTICATION_FAILED: Qualcosa è andato storto con l'autenticazione\"" message: type: string description: 'ENG: Error message - IT: Messaggio di errore' maxLength: 250 pattern: ^[\w\s.,!?'"-]+$ RetryAfter: description: The number of seconds to wait before allowing a follow-up request type: integer format: int32 minimum: 1 maximum: 240 RateLimitLimit: description: The number of allowed requests in the current period type: integer format: int32 minimum: 1 maximum: 240 RateLimitReset: description: The number of seconds left in the current period type: integer format: int32 minimum: 1 maximum: 60 AccessControlAllowOrigin: description: Indicates whether the response can be shared with requesting code from the given origin type: string pattern: ^[ -~]{1,2048}$ minLength: 1 maxLength: 2048 ListCitizenConsentResponseDTO: type: array maxItems: 1000000000 description: Lista di CitizenConsentResponseDTO items: $ref: '#/components/schemas/CitizenConsentResponseDTO' CitizenConsentResponseDTO: type: object description: Schema di risposta che contiene lo stato e la data dei consensi properties: fiscalCode: type: string example: RSSMRO92S18L048H description: Codice fiscale del cittadino pattern: ^[A-Za-z0-9]{11,16}$ minLength: 11 maxLength: 16 consents: type: object description: Oggetto contenente consensi con chiavi dinamiche basate su tppId (UUID concatenati con timestamp) additionalProperties: type: object properties: tppState: type: boolean description: Stato del consenso TPP example: true tcDate: type: string format: date-time description: Data e ora dell'ultimo aggiornamento del consenso example: '2024-11-01T11:25:40.695Z' maxLength: 30 pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ required: - tppState - tcDate required: - fiscalCode - consents examples: example1: summary: Esempio con consenso attivo value: fiscalCode: RSSMRO92S18L048H consents: 0e3bee29-8753-447c-b0da-1f7965558ec2-1706867960900: tppState: true tcDate: '2024-11-06T11:25:40.695Z' example2: summary: Esempio con consenso disattivo value: fiscalCode: RSSMRO92S18L048H consents: 0e3bee29-8753-447c-b0da-1f7965558ec2-1706867960900: tppState: false tcDate: '2024-11-06T11:25:40.695Z' securitySchemes: oAuth2: description: 'A bearer token in the format of a JWS and conforms to the specifications included in RFC8725. ' type: oauth2 flows: clientCredentials: tokenUrl: /token refreshUrl: /token scopes: {} x-refined-from: - mdc-emd-citizen.yml - pagopa-mdc-citizen-consent-openapi.yml