Interfaccia REST per il recupero delle informazioni crittografiche

GovWay gestisce l’endpoint dedicato all’esposizione delle informazioni crittografiche correnti, messe a disposizione dal servizio, in conformità al formato previsto dalla specifica OpenAPI riportata di seguito.

L’endpoint consente inoltre di richiedere, tramite un parametro opzionale della query string, le informazioni crittografiche associate a uno specifico signalId, abilitando l’accesso anche a eventuali dati storici correlati.

Listato 1 Specifica OpenAPI - Risorsa di pseudoanonimizzazione
 1openapi: 3.0.1
 2info:
 3  title: Risorsa di pseudoanonimizzazione implementata da GovWay
 4  version: 1.0.0
 5paths:
 6  /pseudonymization:
 7    get:
 8      summary: Gets a pseudonymization info
 9      description: Info about crypto hash function and seed
10      parameters:
11        - in: query
12          name: signalId
13          schema:
14            type: integer
15          required: false
16          description: SignalID
17      responses:
18        "200":
19          description: Success
20          content:
21            application/json:
22              schema:
23                type: object
24                properties:
25                  seed:
26                    example: 3b9942ce-1f07-4512-8f34-f31b1a7b0061
27                    type: string
28                  cryptoHashFunction:
29                    example: sha256
30                    type: string
31                required:
32                  - seed
33                  - cryptoHashFunction
34                description: Success