Passa al contenuto principale

Introduzione alla Piattaforma Fabrick

Scopri come utilizzare il Consumer Portal per configurare il tuo account Fabrick e ottenere accesso immediato alle nostre API. Oppure approfondisci le funzionalità delle API per imparare come iniziare a costruire la tua integrazione.

Consumer Portal​

Il Customer Portal di Fabrick è un portale web che consente ai clienti Fabrick di configurare il proprio account.

Qui puoi consultare il manuale.

È possibile accedere al Customer Portal direttamente dalla voce di menu Login in cima a ogni pagina del sito Fabrick. Accedendo al profilo privato, è possibile utilizzare le seguenti funzionalità:

  • Informazioni personali. È possibile consultare le informazioni personali relative al proprio account.
  • Configurazione account. Una sezione che consente la configurazione delle impostazioni a livello di account (ad es., soglie per le chiamate di pagamento).
  • Configurazioni a livello di APIKey. Una sezione che consente la configurazione delle seguenti opzioni di sicurezza per ciascuna delle proprie APIKey: whitelist degli indirizzi IP, limiti alle chiamate di pagamento a livello di APIKey e URL di reindirizzamento.

Supportiamo l'accesso al profilo privato tramite Credenziali Fabrick o Credenziali Sella. Se non sei sicuro delle credenziali da utilizzare per accedere al tuo profilo privato, contatta il nostro Supporto Clienti.

Accesso con Account Fabrick​

Per accedere al tuo profilo privato, avrai bisogno delle tue credenziali di identificazione cliente Fabrick, ovvero:

  • La tua EMAIL.
  • La tua PASSWORD.

Se hai problemi con le credenziali di accesso al tuo Account Fabrick, contatta il nostro Supporto Clienti.

API | Panoramica​

Una volta configurato correttamente il tuo Account Fabrick accedendo al tuo profilo privato sul Consumer Portal, sei abilitato a invocare le nostre API.

La Piattaforma Fabrick espone numerosi pacchetti di API web RESTful; la piattaforma contribuisce a uniformare e standardizzare i servizi, aiutando così gli sviluppatori finali a utilizzare tutte le API esposte come un insieme coerente e uniforme di funzioni.

Abbiamo adottato un modello condiviso di Ciclo di Vita delle API e di Ambienti come concetti di base comuni a ogni pacchetto di API esposto.

Ciclo di Vita delle API​

  • In arrivo. Questa fase identifica i gruppi di API che sono stati accettati per la pubblicazione, ma sono ancora in fase di analisi, pertanto non è possibile pubblicare alcuna documentazione.
  • Versione Beta. Questa fase identifica i gruppi di API che sono stati rilasciati — ovvero gli endpoint sono disponibili negli ambienti MOCKUP | SANDBOX | LIVE — ma sui quali stiamo ancora apportando le ultime correzioni. Questi gruppi di API devono essere utilizzati esclusivamente per sperimentazione e/o test; sconsigliamo l'utilizzo delle API in versione BETA per scopi produttivi.
  • Produzione. Questa fase identifica i gruppi di API attivi in produzione. Solo questi gruppi di API devono essere utilizzati per scopi produttivi.
  • Deprecato. Questa fase identifica i gruppi di API che sono stati sostituiti da una versione più recente. È ancora possibile utilizzare queste API per scopi produttivi, ma si raccomanda di migrare il prima possibile all'ultima versione disponibile, poiché il supporto a queste API è stato interrotto.

Ambienti​

Forniamo due ambienti diversi per accedere alle nostre API, ciascuno con profili di sicurezza e limitazioni differenti.

  • SANDBOX Ambiente di sviluppo e test, con piena applicazione delle politiche di sicurezza; è richiesta una chiave API. Le invocazioni API restituiscono risposte con contenuti dinamici ben formati, ma con dati non sincronizzati.
  • LIVE Ambiente di produzione, con piena applicazione delle politiche di sicurezza; è richiesta una chiave API. Le invocazioni API restituiscono risposte ben formate con contenuti dinamici online.

Invocare le API della Piattaforma Fabrick​

Una volta definito l'ambiente in cui si desidera operare, si è pronti a invocare la prima API della Piattaforma Fabrick.

Ogni richiesta API deve essere inviata tramite il protocollo HTTP, utilizzando il verbo HTTP corretto come documentato nella documentazione tecnica dell'endpoint. Ogni richiesta deve contenere almeno i seguenti header (header aggiuntivi possono essere specificati nella documentazione tecnica di ciascun endpoint):

Content-Type : 'application/json'  
Auth-Schema : 'S2S'
Api-Key : '{APIKey}'

La codifica del corpo della richiesta e della risposta è sempre UTF-8.
I parametri di input obbligatori devono essere forniti come blocchi di dati JSON nel corpo di ogni richiesta, ad esempio:

{
    "accountNumber" : "{un-numero-di-conto}"
}

Quando sono richiesti più parametri, è sufficiente fornire più coppie chiave/valore all'interno dello stesso blocco di dati JSON.