{"id":309,"date":"2021-03-05T12:47:41","date_gmt":"2021-03-05T11:47:41","guid":{"rendered":"http:\/\/159.213.227.18\/wordpress\/?p=309"},"modified":"2021-11-10T10:21:23","modified_gmt":"2021-11-10T09:21:23","slug":"termini-tecnici-dellaccordo-di-servizio-cart","status":"publish","type":"post","link":"http:\/\/159.213.227.18\/wordpress\/it\/termini-tecnici-dellaccordo-di-servizio-cart\/","title":{"rendered":"Termini tecnici dell&#8217;accordo di servizio CART"},"content":{"rendered":"\n<p>Le applicazioni che si integrano al CART per accedere a determinate API, hanno ricevuto le credenziali di accesso e quindi le autorizzazioni necessarie per effettuare le proprie richieste. Oltre a tutte le implicazioni tecniche, legate alla natura del servizio ed ai vincoli di sicurezza, che dovranno essere indirizzate dagli sviluppatori degli applicativi, ci sono ulteriori caratteristiche tecniche, proprie degli aspetti di gestione del CART, che devono essere conosciute, accettate e gestite dagli applicativi client.<\/p>\n\n\n\n<p>Occorre innanzitutto distinguere i seguenti casi:<\/p>\n\n\n\n<ul><li><strong>API con interazione sincrona<\/strong>, dove \u00e8 prevista la ricezione, da parte dell&#8217;applicativo client, della risposta del servizio sulla medesima connessione avviata con la richiesta.<\/li><li><strong>API con interazione asincrona<\/strong>, dove \u00e8 prevista la presa in carico della richiesta da parte del CART. Sar\u00e0 compito del CART gestire in una fase successiva la consegna della richiesta al servizio destinatario.<\/li><\/ul>\n\n\n\n<p>Vediamo il dettaglio dei due casi.<\/p>\n\n\n\n<h2>API con interazione sincrona<\/h2>\n\n\n\n<p>Alle richieste inviate dagli applicativi client il CART assegna un identificativo interno, <strong>X-CART-id<\/strong>, che viene restituito al client con la risposta.<\/p>\n\n\n\n<p>\u00c8 richiesto che l&#8217;applicativo client acquisisca e conservi l&#8217;identificativo CART della transazione al fine di poterlo utilizzare per il tracciamento delle proprie richieste. Tale identificativo servir\u00e0 ad indirizzare efficacemente l&#8217;indagine diagnostica, nel caso di problematiche riscontrate sulle quali si intende ricevere supporto.<\/p>\n\n\n\n<p>In alcune situazioni anomale pu\u00f2 accadere che il CART non restituisca l&#8217;identificativo della transazione, in tal caso l&#8217;applicativo deve considerare la richiesta come &#8220;non presa in carico&#8221;. A seconda dell&#8217;errore ottenuto, l&#8217;applicativo deve stabilire se sia necessaria una rispedizione della richiesta. Si presenta la seguente casistica:<\/p>\n\n\n\n<ul><li><strong>Errori permanenti<\/strong>: sono i casi in cui l&#8217;applicativo non deve procedere con la rispedizione della richiesta poich\u00e9 l&#8217;errore riscontrato non si risolver\u00e0. Tali errori sono associati ai seguenti codici HTTP di ritorno: <em>400, 401, 403, 404, 409, 429 (Rate Limiting &#8211; Limit Exceeded)<\/em><\/li><li><strong>Errori temporanei<\/strong>: sono i casi in cui la problematica riscontrata pu\u00f2 essere causata da un problema temporaneo. In questi casi ha senso che l&#8217;applicativo proceda con la rispedizione della richiesta. Tali errori sono associati ai seguenti codici HTTP di ritorno: <em>429 (Rate Limiting &#8211; Too Many Requests), 502, 503, 504<\/em>. Nei casi HTTP 502 e 504 occorre prestare attenzione che per le operazioni di scrittura sia garantita l&#8217;idempotenza, altrimenti si rischia di creare duplicazioni.<\/li><\/ul>\n\n\n\n<h2>API con interazione asincrona<\/h2>\n\n\n\n<p>Le richieste inviate per questo tipo di API prevedono la restituzione dell&#8217;identificativo CART a conferma della presa in carico del messaggio. <\/p>\n\n\n\n<p>La mancata restituzione dell&#8217;identificativo pu\u00f2 essere gestita, per stabilire l&#8217;eventuale rispedizione, in maniera analoga a quanto descritto per le API con interazione sincrona.<\/p>\n\n\n\n<p>La presa in carico del messaggio da parte del CART significa che sar\u00e0 l&#8217;infrastruttura ad occuparsi della consegna, in modalit\u00e0 asincrona, al servizio destinatario.<\/p>\n\n\n\n<p>Dovendo il CART mantenere il messaggio preso in carico per il tempo necessario alla sua consegna, \u00e8 necessario che le politiche di gestione delle richieste lato client tengano conto dei seguenti limiti:<\/p>\n\n\n\n<ul><li>Consegna in modalit\u00e0 &#8220;Trasparente&#8221;: cio\u00e8 nei casi in cui il CART consegna la richiesta direttamente all&#8217;endpoint del servizio destinatario. In questi casi il limite di tenuta del messaggio sul CART \u00e8 di<strong> 5 giorni<\/strong>.<\/li><li>Consegna in modalit\u00e0 &#8220;Integration Manager&#8221;: cio\u00e8 nei casi in cui il CART tiene in una &#8220;Message Box&#8221; la richiesta in attesa che il servizio erogatore la prelevi. In questi casi il limite di tenuta del messaggio sul CART \u00e8 di<strong> 15 giorni<\/strong>.<\/li><\/ul>\n\n\n\n<p>Trascorsi i limiti di tempo suddetti, i messaggi vengono cancellati e quindi non potranno pi\u00f9 essere consegnati all&#8217;erogatore del servizio.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Le applicazioni che si integrano al CART per accedere a determinate API, hanno ricevuto le credenziali di accesso e quindi le autorizzazioni necessarie per effettuare le proprie richieste. Oltre a tutte le implicazioni tecniche, legate alla natura del servizio ed ai vincoli di sicurezza, che dovranno essere indirizzate dagli sviluppatori degli applicativi, ci sono ulteriori [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":380,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[22],"tags":[],"_links":{"self":[{"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/posts\/309"}],"collection":[{"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/comments?post=309"}],"version-history":[{"count":8,"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/posts\/309\/revisions"}],"predecessor-version":[{"id":317,"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/posts\/309\/revisions\/317"}],"wp:featuredmedia":[{"embeddable":true,"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/media\/380"}],"wp:attachment":[{"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/media?parent=309"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/categories?post=309"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/159.213.227.18\/wordpress\/wp-json\/wp\/v2\/tags?post=309"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}