SEND - F.A.Q. per integratori
v2.0
v2.0
  • Knowledge-base di Piattaforma Notifiche
    • Generazione client e definizioni delle API
    • Workflow di Notifica
    • FAQ inserimento notifiche
    • FAQ sulle streams
    • Focus su Interoperabilità e generazione Voucher per SEND - UAT (Piattaforma Notifiche)
      • Configurare l'accesso ad Interoperabilità
      • Focus su creazione richiesta di fruizione generazione Voucher per SEND - UAT (Piattaforma Notifiche)
      • FAQ su Interoperabilità
    • Focus sull'inserimento della notifica
      • Inserimento Notifica con il comando curl
      • Inserimento Notifica con Postman
    • Focus sulla creazione e gestione delle stream
      • Inserimento e creazione stream con il comando curl
      • Inserimento e creazione stream con Postman
    • Focus sulla validazione della Richiesta di invio Notifica
    • Focus sul Perfezionamento della notifica
    • Focus sull'attualizzazione della posizione debitoria
    • PN-Test di validazione avvenuta integrazione con Piattaforma Notifiche
    • Focus sulla validazione dei test con il tool PnValidator
  • Normalizzatore
  • Modalità per simulare i casi di test in ambiente UAT
  • Composizione degli indirizzi
  • API CHANGELOG
    • API VERSIONE GA 2.0
Powered by GitBook
On this page
  • Generazione dei client
  • Client b2b Java
  • Importare le definizioni delle API su Postman
  • Come creare la propria apikey?
  • Qual è il ciclo di vita delle apikey?
  • Come generare il Voucher?
  1. Knowledge-base di Piattaforma Notifiche

Generazione client e definizioni delle API

Informazioni utili sulla generazione dei client e sulle modalità di utilizzo delle API

Last updated 1 year ago

Generazione dei client

E' possibile generare il client per tutti i linguaggi di programmazione, con il tool openapi-generator la cui documentazione è presente al seguente link: Dopo aver scaricato il tool sulla propria macchina, bisognerà lanciare il seguente comando:

openapi-generator-cli generate -i <urlFileSwagger> -g <lang> -o <dest>

sostituendo:

  • <urlFileSwagger>: con la url del file Swagger del quale si vuole generare il client. E' possibile utilizzare:

  • <lang>: con il linguaggio per il quale si vuole generare il client

  • <dest>: con il path nel quale si vuole generare il client

Client b2b Java

E' anche possibile utilizzare il pubblico sviluppato da PagoPA ed utilizzare le classi Java in esso contenute per sviluppare la propria soluzione

Importare le definizioni delle API su Postman

Per importare le definizioni su Postman bisogna cliccare su "import", poi selezionare "Link" ed inserire il seguente url:

Poi modificare i seguenti parametri delle collections ottenute:

  • nel tab "Variables" modificare la variables baseUrl con: (ambiente di collaudo UAT)

  • nel tab "Authorization" selezionare nella tendina "Type" il valore "API Key", poi inserire nella casella "Key" il valore x-api-key e nella casella "Value" il valore della key generata dalla propria area riservata (di seguito le istruzioni)

  • aggiungere il "Authorization: Bearer <PDNDVoucher>"in ogni chiamata verso i servizi B2B (ad esclusione di quelli verso AWS) con il Voucher ottenuto da PDND Interoperabilità ed assicurarsi che sia sempre valido e non scaduto.

Come creare la propria apikey?

NOTA: Se si crea una apiKey associata ad un gruppo, diventerà obbligatorio inserire notifiche valorizzando il campo "group" con l'id del gruppo di appartenenza.

Qual è il ciclo di vita delle apikey?

Le operazioni di creazione, rotazione ed eliminazione sulle apiKey sono dettate dal volere dell'utente che può gestirle a propria discrezione.

Come generare il Voucher?

vedi:

Per creare le apikey bisognerà effettuare il log in nel portale lato PA da qui: con le credenziali che sono state fornite durante il processo di Onboarding, andare nella sezione apikey, cliccare su “genera Apikey”, inserire il nome dell’apikey e selezionare “continua”.

https://openapi-generator.tech
https://raw.githubusercontent.com/pagopa/pn-delivery/v2.1.0/docs/openapi/api-external-b2b-pa-bundle.yaml
pn-b2b-client
https://raw.githubusercontent.com/pagopa/pn-delivery/v2.1.0/docs/openapi/api-external-b2b-pa-bundle.yaml
https://api.uat.notifichedigitali.it
https://uat.selfcare.pagopa.it/auth/login
Focus su creazione richiesta di fruizione generazione Voucher per SEND - UAT (Piattaforma Notifiche)