{"id":1794,"date":"2022-02-21T08:05:35","date_gmt":"2022-02-21T07:05:35","guid":{"rendered":"http:\/\/documentation-wp.hub.av.priv\/aurora-vision-apis\/user-guide\/"},"modified":"2022-06-08T09:08:21","modified_gmt":"2022-06-08T08:08:21","slug":"user-guide","status":"publish","type":"page","link":"http:\/\/documentation-wp.hub.av.priv\/it\/aurora-vision-apis\/user-guide\/","title":{"rendered":"Guida Utente"},"content":{"rendered":"\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Al fine di garantire all&#8217;utente finale un&#8217;esperienza a 360\u00b0, abbiamo realizzato una guida utente che copre i principali argomenti delle Aurora Vision APIs con l&#8217;obiettivo di fornire le principali linee guida per l&#8217;utilizzo del servizio e delle sue implementazioni. La guida si aggiorner\u00e0 nel tempo: aggiungeremo nuove sezioni e perfezioneremo la trattazione di argomenti o temi specifici e lo faremo in base sia alle carenze che evidenzieremo sia ai feedback ottenuti dagli utenti finali.<\/p>\n\n\n\n<p>L&#8217;accesso alle varie sezioni della guida \u00e8 semplice: clicca su una delle voci presenti nel box a sinistra, verrai reindirizzato alla pagina di tuo interesse pur potendo comunque navigare interattivamente la guida quando e come vuoi.<\/p>\n\n\n\n<p>Per semplificarti la vita per iniziare a sviluppare rispetto alle nostre APIs, abbiamo creato un modello che puoi scaricare e importare direttamente in Postman in modo da avere tutte le suite e le chiamate APIs aggiornate:<\/p>\n\n\n\n<div class=\"wp-block-columns has-black-color has-text-color has-background\" style=\"background-color:#e6e6e6\">\n<div class=\"wp-block-column\">\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" width=\"752\" height=\"300\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/pm-orange-logo-horiz.png\" alt=\"\" class=\"wp-image-6981\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/pm-orange-logo-horiz.png 752w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/pm-orange-logo-horiz-300x120.png 300w\" sizes=\"(max-width: 752px) 100vw, 752px\" \/><figcaption>Hai bisogno di una guida rapida per Postman? Vai a <strong>Pagina 2<\/strong>!<\/figcaption><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><strong>Aurora Vision Open APIs &#8211; Postman Template<\/strong><br>Ultimo Aggiornamento: 05\/05\/2022<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<div class=\"wp-container-1 wp-block-buttons\">\n<div class=\"wp-block-button has-custom-width wp-block-button__width-100 is-style-fill\"><a class=\"wp-block-button__link\" href=\"http:\/\/documentation-wp.hub.av.priv\/av-api\/av-api-v3.yaml\" style=\"border-radius:0px\" target=\"_blank\" rel=\"noreferrer noopener\" download=\"Aurora_Vision_Open_APIs_REV20220511_Developers_Guide_POSTMAN.yaml\">\u2b73&nbsp;&nbsp;&nbsp;Download Postman Template<\/a><\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n<p>Cosa stai aspettando?&nbsp;<strong>Immergiti nel mondo delle APIs Aurora Vision e mostraci di cosa sei capace<\/strong>!<\/p>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<!--nextpage-->\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2>Guida alla configurazione rapida di Postman<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Questa pagina ha lo scopo di fornire le informazioni principali su come impostare uno spazio di lavoro su Postman ed importare il modello API di Aurora Vision. Una volta importata la collezione, spiegheremo la struttura del template delle APIs e come eseguire una <code>Authentication <\/code>per il rilascio di un <code>X-AuroraVision-Token<\/code>.<br>Per informazioni approfondite su Postman e la guida ufficiale, fare riferimento a <a rel=\"noreferrer noopener\" href=\"https:\/\/learning.postman.com\/docs\/getting-started\/introduction\/\" target=\"_blank\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">Postman Learning Center<\/mark><\/a>.<\/p>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Scarica il modello API di Aurora Vision, avvia Postman e configura il tuo spazio di lavoro.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"390\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-1024x390.png\" alt=\"\" class=\"wp-image-7675\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-1024x390.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-300x114.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-768x293.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-1536x585.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-2048x781.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Clicca su <strong>Import<\/strong> per importare una nuova collezione su Postman, si aprir\u00e0 una finestra dedicata.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"391\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import-1-1024x391.png\" alt=\"\" class=\"wp-image-7713\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import-1-1024x391.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import-1-300x114.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import-1-768x293.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import-1-1536x586.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import-1-2048x781.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Carica il modello delle API Aurora Vision che hai scaricato inizialmente come file (<em>non preoccuparti se si tratta di un file <code>.txt<\/code>, la codifica segue il modello Swagger secondo linguaggio <code>YAML <\/code>e Postman sar\u00e0 in grado di riconoscerlo<\/em>)<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"391\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_settings-1-1024x391.png\" alt=\"\" class=\"wp-image-7721\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_settings-1-1024x391.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_settings-1-300x114.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_settings-1-768x293.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_settings-1-1536x586.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_settings-1-2048x781.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Nelle impostazioni di importazione del modello, imposta:<\/p>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<ul><li><strong>Naming requests <\/strong>come Fallback;<\/li><li><strong>Set indent character<\/strong> come Space;<\/li><li><strong>Collapse redundant folder<\/strong> come Active;<\/li><li><strong>Optimize conversion<\/strong> come Active;<\/li><li><strong>Request parameter generation<\/strong> come Example;<\/li><li><strong>Response parameter generation<\/strong> come Example;<\/li><li><strong>Folder organization<\/strong> come Tags;<\/li><li><strong>Include auth info in example request<\/strong> come Active;<\/li><li><strong>Disable optional parameters<\/strong> come Inactive;<\/li><\/ul>\n<\/div>\n<\/div>\n\n\n\n<p>Fai clic su Importa ed attendi che Postman termini l&#8217;importazione del modello.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"389\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_done-1024x389.png\" alt=\"\" class=\"wp-image-7756\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_done-1024x389.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_done-300x114.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_done-768x292.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_done-1536x584.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_import_done-2048x778.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>A questo punto \u00e8 stata creata una raccolta nell&#8217;area di lavoro, nella scheda Raccolte, ed una cartella, nella scheda API, entrambe con il nome Aurora Vision APIs.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"390\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-1-1024x390.png\" alt=\"\" class=\"wp-image-7767\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-1-1024x390.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-1-300x114.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-1-768x293.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-1-1536x585.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_workspace-1-2048x781.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Espandendo la cartella sar\u00e0 disponibile l&#8217;intera gerarchia delle chiamate offerte, suddivisa per tag, che altro non sono che le suite mostrate anche nel modello Swagger.<\/p>\n\n\n\n<p>Dalla cartella <strong>Authentication<\/strong>, seleziona <code>GET Authenticate<\/code>.<br>Si aprir\u00e0 l&#8217;API di autenticazione, con la scheda <strong>Params <\/strong>evidenziata.<br>Per avere una response corretta, per il rilascio di un <code>X-AuroraVision-Token<\/code>, \u00e8 necessario autenticarsi al servizio con le credenziali Aurora Vision e la <code>X-AuroraVision-ApiKey<\/code>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"392\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_authenticate-1-1024x392.png\" alt=\"\" class=\"wp-image-7791\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_authenticate-1-1024x392.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_authenticate-1-300x115.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_authenticate-1-768x294.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_authenticate-1-1536x589.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/postman_authenticate-1-2048x785.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Clicca sul tab <strong>Authorization <\/strong>e da l\u00ec seleziona <strong>Basic Auth<\/strong> dal men\u00f9 a tendina.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"390\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/basic_auth-1024x390.png\" alt=\"\" class=\"wp-image-7801\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/basic_auth-1024x390.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/basic_auth-300x114.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/basic_auth-768x293.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/basic_auth-1536x585.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/basic_auth-2048x781.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Inserisci <strong>UserID <\/strong>e <strong>Password <\/strong>del tuo account Aurora Vision.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"391\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/credentials-1024x391.png\" alt=\"\" class=\"wp-image-7809\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/credentials-1024x391.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/credentials-300x114.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/credentials-768x293.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/credentials-1536x586.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/credentials-2048x781.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Clicca sul tab <strong>Headers <\/strong>ed inserisci la <code>X-AuroraVision-ApiKey<\/code>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"378\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/api-key-1024x378.png\" alt=\"\" class=\"wp-image-7820\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/api-key-1024x378.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/api-key-300x111.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/api-key-768x283.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/api-key-1536x567.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/api-key-2048x755.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Clicca su <strong>Send<\/strong> e la chiamata verr\u00e0 inviata ad Aurora Vision che, una volta verificate le credenziali e la <code>X-AuroraVision-ApiKey<\/code>, fornir\u00e0 una risposta (<em>JSON default format<\/em>) che conterr\u00e0 l&#8217; <code>X-AuroraVision-Token<\/code>.<\/p>\n\n\n\n<p>Il token \u00e8 l&#8217;<code>header<\/code> di tutte le chiamate API offerte e scade dopo 60 minuti di completa inattivit\u00e0; questo significa che non \u00e8 necessario eseguire l&#8217;API <code>GET Authentication<\/code> ogni volta per emettere un nuovo <code>X-AuroraVision-Token<\/code> se quello che hai gi\u00e0 non \u00e8 scaduto.<\/p>\n\n\n\n<p>Per una guida completa sulle chiamate disponibili, consulta la pagina <a href=\"http:\/\/documentation-wp.hub.av.priv\/aurora-vision-apis\/openapi-preview\/\" data-type=\"page\" data-id=\"74\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">OpenAPIs Swagger<\/mark><\/a>.<\/p>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n","protected":false},"excerpt":{"rendered":"<p>Al fine di garantire all&#8217;utente finale un&#8217;esperienza a 360\u00b0, abbiamo realizzato una guida utente che copre i principali argomenti delle Aurora Vision APIs con l&#8217;obiettivo di fornire le principali linee guida per l&#8217;utilizzo del servizio e delle sue implementazioni. La guida si aggiorner\u00e0 nel tempo: aggiungeremo nuove sezioni e perfezioneremo la trattazione di argomenti o [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":1766,"menu_order":3,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"http:\/\/documentation-wp.hub.av.priv\/it\/wp-json\/wp\/v2\/pages\/1794"}],"collection":[{"href":"http:\/\/documentation-wp.hub.av.priv\/it\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"http:\/\/documentation-wp.hub.av.priv\/it\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"http:\/\/documentation-wp.hub.av.priv\/it\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"http:\/\/documentation-wp.hub.av.priv\/it\/wp-json\/wp\/v2\/comments?post=1794"}],"version-history":[{"count":43,"href":"http:\/\/documentation-wp.hub.av.priv\/it\/wp-json\/wp\/v2\/pages\/1794\/revisions"}],"predecessor-version":[{"id":10565,"href":"http:\/\/documentation-wp.hub.av.priv\/it\/wp-json\/wp\/v2\/pages\/1794\/revisions\/10565"}],"up":[{"embeddable":true,"href":"http:\/\/documentation-wp.hub.av.priv\/it\/wp-json\/wp\/v2\/pages\/1766"}],"wp:attachment":[{"href":"http:\/\/documentation-wp.hub.av.priv\/it\/wp-json\/wp\/v2\/media?parent=1794"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}