info:
  name: recupero metadati allegati maturità
  type: http
  seq: 12
  tags:
    - allegati

http:
  method: GET
  url: "{{baseUrl}}/allegati/:persId/allegatiMatur/?annoMaturita="
  params:
    - name: annoMaturita
      value: ""
      type: query
      description: anno di maturità, coincide con l'anno solare della data di conseguimento del diploma. Per esempio, anno scolastico 2019/2020, l'anno di diploma è 2020
    - name: idDiplomaMiur
      value: ""
      type: query
      description: identificativo diploma MIUR
      disabled: true
    - name: dataMaturita
      value: ""
      type: query
      description: data di maturità
      disabled: true
    - name: maturId
      value: ""
      type: query
      description: identificativo della maturità
      disabled: true
    - name: tipologiaAllegato
      value: ""
      type: query
      description: tipologia dell'allegato relativo all'entità p17_tipologia_allegati
      disabled: true
    - name: validoFlg
      value: ""
      type: query
      description: flag che indica se l'allegato risulta validato o meno
      disabled: true
    - name: persId
      value: ""
      type: path
      description: identificativo della persona
  auth: inherit

settings:
  encodeUrl: true
  timeout: 0
  followRedirects: true
  maxRedirects: 5
  forwardAuthorizationHeader: true

examples:
  - name: 200 Response
    description: Successful response
    request:
      url: "{{baseUrl}}/allegati/:persId/allegatiMatur/"
      method: GET
      params:
        - name: persId
          value: ""
          type: path
          description: identificativo della persona
        - name: annoMaturita
          value: ""
          type: query
          description: anno di maturità, coincide con l'anno solare della data di conseguimento del diploma. Per esempio, anno scolastico 2019/2020, l'anno di diploma è 2020
        - name: idDiplomaMiur
          value: ""
          type: query
          description: identificativo diploma MIUR
          disabled: true
        - name: dataMaturita
          value: ""
          type: query
          description: data di maturità
          disabled: true
        - name: maturId
          value: ""
          type: query
          description: identificativo della maturità
          disabled: true
        - name: tipologiaAllegato
          value: ""
          type: query
          description: tipologia dell'allegato relativo all'entità p17_tipologia_allegati
          disabled: true
        - name: validoFlg
          value: ""
          type: query
          description: flag che indica se l'allegato risulta validato o meno
          disabled: true
    response:
      status: 200
      statusText: OK
      body:
        type: text
        data: ""
  - name: 422 Response
    description: parametri Errati
    request:
      url: "{{baseUrl}}/allegati/:persId/allegatiMatur/"
      method: GET
      params:
        - name: persId
          value: ""
          type: path
          description: identificativo della persona
        - name: annoMaturita
          value: ""
          type: query
          description: anno di maturità, coincide con l'anno solare della data di conseguimento del diploma. Per esempio, anno scolastico 2019/2020, l'anno di diploma è 2020
        - name: idDiplomaMiur
          value: ""
          type: query
          description: identificativo diploma MIUR
          disabled: true
        - name: dataMaturita
          value: ""
          type: query
          description: data di maturità
          disabled: true
        - name: maturId
          value: ""
          type: query
          description: identificativo della maturità
          disabled: true
        - name: tipologiaAllegato
          value: ""
          type: query
          description: tipologia dell'allegato relativo all'entità p17_tipologia_allegati
          disabled: true
        - name: validoFlg
          value: ""
          type: query
          description: flag che indica se l'allegato risulta validato o meno
          disabled: true
    response:
      status: 422
      statusText: Unprocessable Entity
      body:
        type: text
        data: ""

docs: |
  <span class="e3rest-operation-auth-img-list"><img src="basic.png"/><img src="jwt.png"/></span>consente di recuperare i metadati degli allegati di maturità.  Il blob dell'allegato può essere scaricato tramite l'api degli allegati utilizzando l'allegatoId e ed il tipoAssAllegato recuperato con questo servizio.

  **Estensioni:**

  Codice Estensione|Valore|Nota
  -|-|-
  x-cache-type|lowRefreshRateUserIndependent|Risorsa che varia con frequenza bassa, cache Http abilitata, cache server abilitata. Maggiori dettagli [qui](https://wiki.u-gov.it/confluence/display/ESSE3/Servizi+REST+su+ESSE3#ServiziRESTsuESSE3-Cachingdellerichieste) 


  **Controlli di sicurezza:**
  ======
  _Nota: Il controllo per utente è verificato quando viene passato almeno uno dei controlli previsti_

  **Utente: USER_TECNICO**

  Profilo|Controllo| Funzione
  -|-|-
  UTENTE_TECNICO|funzione accessibile alle utenze tecniche per accessi ai servizi REST|Security.checkUserTecnico()


  Classe di modello : DettaglioErroreAggiuntivo
  ======

  Estensioni sulle proprietà
  ----
  Proprietà | x-field-type
  -|-|
  rawValue|rawJson
