Procedure Implementazione Servizi HTTP Terze Parti

Procedure Implementazione Servizi HTTP Terze Parti

Esempio di HTTP Request

Una volta ottenuto un riscontro positivo da parte di EGG finance a integrarsi come partner,  il primo passo da seguire è quello di fornire una HTTP Request in formato CURL funzionante e comprensiva di tutti i parametri che dovranno essere utilizzati a regime. Se ci sono diverse tipologie di chiamate puoi inviare le diverse chiamate con una descrizione in allegato rispetto all'utilizzo.

Se devi autorizzare una lista di IP di accesso, al presente link troverai tutti gli IP da abilitare.

Qualora il servizio dovesse utilizzare il protocollo OAuth per gestire l'autenticazione, puoi inviare un esempio di chiamata per generare il token, eventuale esempio di chiamata per il refresh del token e infine la chiamata finale.
  1. curl --location --request GET 'https://example/com/service/v1/oauth/token?grant_type=password&client_id=xxxxxxxxx&client_secret=xxxxxxxxxx&username=xxxxxx&password=xxxxx'
  2. curl -k --location --request POST 'https://example/com/service/v1' \
    --header 'Content-Type: application/xml' \
    --header 'Authorization: Bearer xxxxxxxxxxx' \
    --data-raw '{"example": true}'


Qualora il servizio dovesse utilizzare un certificato, allega un certificato funzionante (ed eventuale password) nell'esempio fornito (consigliamo il formato PKCS 12).
  1. curl -k --location --request POST 'https://example/com/service/v1' \
    --cert-type P12 --cert cert.p12:'password' \
    --header 'Content-Type: application/xml' \
    --data-raw '{"example": true}'

Modalità di Accesso

Indica se l'accesso è per istanza o per singolo utente. Ad esempio alcuni servizi richiedono l'accesso globale dell'azienda, per altri è necessario l'accesso del singolo utente.

TEST e PROD

Specifica le differenze tra ambiente di test e di produzione (es. link differente, modalità specifiche).

Definizione Variabili e Configurazioni Globali Istanza

Se la richiesta HTTP prevede variabili e configurazioni globali per la singola istanza / utente di accesso indica il parametro nella richiesta, descrizione sull'utilizzo, eventuali valori accettati (o riferimento alla documentazione / HTTP Request per ottenere i valori) e se il valore è obbligatorio o facoltativo.  La differenza tra variabili e configurazioni globali è che le variabili variano in base a input specifici (es. forniti tramite form).

Ecco un esempio di tabella da fornire:

Configurazioni Globali Istanza (o di Utente)
Parametro
Descrizione
Valori accettati
Obbligatorio
userType
Il parametro nella posizione config.userType nel JSON del body della richiesta e specifica il tipo di utente
A, Bno
Authorization
Il parametro è negli headers e fa riferimento alla richiesta 
"Bearer " + il parametro token ottenuto dalla richiesta HTTP api/auth/token
si

Variabili
ParametroDescrizioneValori accettatiObbligatorio
importoRichiestoIl parametro nella posizione request.importoRichiesto nel JSON del body della richiesta e specifica il tipo di utenteDecimali 12,2si

La stessa mappatura può essere fornita per descrivere l'HTTP Response e relativa ai campi rilevanti da utilizzare per il servizio.





    • Related Articles

    • Pillar Document - EGG finance

      Il presente documento si applica al servizi cloud e di servizio offerti da EGG finance e indicati nelle Condizioni di Fornitura. 1. POLITICA DI SICUREZZA 1.1 Controlli di accesso ai dati Il personale EGG finance può ottenere diritto di accesso al ...

    • Condizioni e Limiti Utilizzo

      Condizioni e Limiti Utilizzo Utenti Il limite degli utenti è indicato nelle condizioni di fornitura e nell’allegato edizioni. Gli utenti conteggiati sono quelli che hanno accesso con user e password ad EGG finance. Rimuovendo l’accesso, non verranno ...

    • Data Processing Agreement

      Ultimo aggiornamento del 01/04/2024 Tra “EGG finance” è EGG finance S.p.A. - sede legale Via Copernico 38 - 20125 Milano - Capitale Sociale 250.000,00 € i.v. (di seguito, Responsabile del trattamento o Fornitore) E “Cliente” ovvero il Cliente ...

    • Informativa Privacy

      INFORMATIVA SULLA PRIVACY “Codice sulla privacy”, Decreto Legislativo 30 giugno 2003 n. 196 1. INTRODUZIONE Questo documento è stato predisposto al fine di illustrare all’utente la politica sulla privacy di EGG Finance S.p.A.. Per “trattamento” si ...

    • EGG zen

      EGG zen EGG zen è un servizio aggiuntivo relativo ad attività di analisi, consulenza, supporto tecnico avanzato, progettazione, sviluppo e interventi tecnici ad hoc su EGG finance. La modalità principale di interazione con EGG zen é il portale ...