{"id":29019,"date":"2019-02-19T00:00:00","date_gmt":"2019-02-18T23:00:00","guid":{"rendered":"https:\/\/blexin.com\/?p=29019"},"modified":"2021-01-13T09:40:45","modified_gmt":"2021-01-13T08:40:45","slug":"documentare-le-api-con-swagger","status":"publish","type":"post","link":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/","title":{"rendered":"Documentare le API con Swagger"},"content":{"rendered":"\n<figure class=\"wp-block-image size-large\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"608\" data-attachment-id=\"29020\" data-permalink=\"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/attachment\/208a28b8-de1f-4321-b877-f7ca01ccaea6\/\" data-orig-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&amp;ssl=1\" data-orig-size=\"1024,608\" data-comments-opened=\"0\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"208a28b8-de1f-4321-b877-f7ca01ccaea6\" data-image-description=\"\" data-image-caption=\"\" data-large-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&amp;ssl=1\" src=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?resize=1024%2C608&#038;ssl=1\" alt=\"\" class=\"wp-image-29020\" srcset=\"https:\/\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png 1024w, https:\/\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6-980x582.png 980w, https:\/\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6-480x285.png 480w\" sizes=\"auto, (min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Di recente ho lavorato al backend di un&#8217;applicazione per un nostro cliente. Alcuni&nbsp;<em>tasks<\/em>&nbsp;erano relativi all&#8217;introduzione di nuove API da annotare con&nbsp;<strong>Swagger<\/strong>&nbsp;ed, in particolare, uno di questi richiedeva di abilitare Swagger solo per l&#8217;<em>environment<\/em>&nbsp;di&nbsp;<em>debug<\/em>&nbsp;e disabilitarlo per quello di&nbsp;<em>produzione<\/em>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ma cos\u2019\u00e8 Swagger? Si tratta di un set di tool che fanno da contorno alla specifica&nbsp;<strong><a href=\"https:\/\/github.com\/OAI\/OpenAPI-Specification\" target=\"_blank\" rel=\"noreferrer noopener\">OpenApi<\/a><\/strong>&nbsp;(<strong>OAS<\/strong>), ovvero lo standard per la descrizione delle API Rest, per creare e documentare tali API. Lo standard&nbsp;<strong>OAS<\/strong>&nbsp;\u00e8 indipendente dal linguaggio di programmazione ed \u00e8 stato pensato per essere compreso sia dalle persone che dai computer. Lo scopo \u00e8 rendere pi\u00f9 comprensibile ci\u00f2 che viene messo a disposizione da un servizio, senza dover accedere al codice sorgente o ad ulteriore documentazione.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In un progetto .Net \u00e8 possibile integrare Swagger installando, tramite\u00a0Nuget, il pacchetto Open Source\u00a0<strong>Swashbuckle<\/strong>. Una volta installato, troveremo nella cartella\u00a0<em>App_start<\/em>\u00a0il file\u00a0<em>SwaggerConfig.cs<\/em>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" width=\"205\" height=\"110\" data-attachment-id=\"29024\" data-permalink=\"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/attachment\/image1-6\/\" data-orig-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image1-6.png?fit=205%2C110&amp;ssl=1\" data-orig-size=\"205,110\" data-comments-opened=\"0\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"image1-6\" data-image-description=\"\" data-image-caption=\"\" data-large-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image1-6.png?fit=205%2C110&amp;ssl=1\" src=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image1-6.png?resize=205%2C110&#038;ssl=1\" alt=\"\" class=\"wp-image-29024\"\/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Tale file contiene diversi commenti utili alla configurazione di\u00a0<strong>Swagger<\/strong>\u00a0per la nostra applicazione. In particolare possiamo indicare un file\u00a0<em>XML<\/em>\u00a0dove verranno salvati i commenti con cui possiamo annotare le nostre API.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: csharp; title: ; notranslate\" title=\"\">\nc.IncludeXmlComments(GetXmlCommentsPath());\n<\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">Per evitare errori bisogna a questo punto andare nelle propriet\u00e0 del progetto e nella scheda\u00a0<em>Build<\/em>, sezione\u00a0<em>Output<\/em>, flaggare l&#8217;opzione &#8220;XML documentation file&#8221;, indicando il file\u00a0<em>XML<\/em>\u00a0di destinazione.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" width=\"657\" height=\"195\" data-attachment-id=\"29026\" data-permalink=\"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/attachment\/image2-5\/\" data-orig-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image2-5.png?fit=657%2C195&amp;ssl=1\" data-orig-size=\"657,195\" data-comments-opened=\"0\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"image2-5\" data-image-description=\"\" data-image-caption=\"\" data-large-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image2-5.png?fit=657%2C195&amp;ssl=1\" src=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image2-5.png?resize=657%2C195&#038;ssl=1\" alt=\"\" class=\"wp-image-29026\" srcset=\"https:\/\/blexin.com\/wp-content\/uploads\/2020\/12\/image2-5.png 657w, https:\/\/blexin.com\/wp-content\/uploads\/2020\/12\/image2-5-480x142.png 480w\" sizes=\"auto, (min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) 657px, 100vw\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Terminata questa configurazione \u00e8 possibile annotare le API con i seguenti&nbsp;<em>tags<\/em>&nbsp;:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Summary<\/li><\/ul>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: csharp; title: ; notranslate\" title=\"\">\n\/\/\/ &lt;summary&gt;\n\/\/\/ Esempio Commenti Swagger\n\/\/\/ &lt;\/summary&gt;\n<\/pre><\/div>\n\n\n<ul class=\"wp-block-list\"><li>Remarks<\/li><\/ul>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: csharp; title: ; notranslate\" title=\"\">\n\/\/\/ &lt;remarks&gt;Osservazioni &lt;\/remarks&gt;\n<\/pre><\/div>\n\n\n<ul class=\"wp-block-list\"><li>Parameter<\/li><\/ul>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: csharp; title: ; notranslate\" title=\"\">\n\/\/\/ &lt;param name=&quot;id&quot; cref=&quot;int&quot;&gt;Value id&lt;\/param&gt;\n\/\/\/ &lt;param name=&quot;value&quot; cref=&quot;string&quot;&gt;Value string&lt;\/param&gt;\n<\/pre><\/div>\n\n\n<ul class=\"wp-block-list\"><li>Response<\/li><\/ul>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: csharp; title: ; notranslate\" title=\"\">\n\/\/\/&lt;response code=&quot;500&quot;&gt;Ops!!! Error 500 &lt;\/response&gt;\n<\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">Consideriamo la seguente\u00a0<em>action<\/em>\u00a0che effettua una\u00a0<em>GET<\/em>.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: csharp; title: ; notranslate\" title=\"\">\n\/\/\/ &lt;summary&gt;\n\/\/\/ Esempio Commenti Swagger\n\/\/\/ &lt;\/summary&gt;\n\/\/\/ &lt;param name=&quot;id&quot; cref=&quot;int&quot;&gt;Value id&lt;\/param&gt;\n\/\/\/ &lt;param name=&quot;value&quot; cref=&quot;string&quot;&gt;Value string&lt;\/param&gt;\n\/\/\/ &lt;remarks&gt;Osservazioni &lt;\/remarks&gt;\n\/\/\/&lt;response code=&quot;500&quot;&gt;Ops!!! Error 500 &lt;\/response&gt;\npublic string Get(int id, string value)\n{\n\u00a0\u00a0\u00a0\u00a0return value+id.ToString();\n}\n<\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">Possiamo vedere il risultato delle annotazioni nella\u00a0<strong><a rel=\"noreferrer noopener\" href=\"https:\/\/swagger.io\/tools\/swagger-ui\/\" target=\"_blank\">SwaggerUI<\/a><\/strong>\u00a0raggiungibile all&#8217;indirizzo: [host]:[port]\/swagger.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" width=\"960\" height=\"378\" data-attachment-id=\"29030\" data-permalink=\"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/attachment\/image3-5-2\/\" data-orig-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image3-5.png?fit=960%2C378&amp;ssl=1\" data-orig-size=\"960,378\" data-comments-opened=\"0\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"image3-5\" data-image-description=\"\" data-image-caption=\"\" data-large-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image3-5.png?fit=960%2C378&amp;ssl=1\" src=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image3-5.png?resize=960%2C378&#038;ssl=1\" alt=\"\" class=\"wp-image-29030\" srcset=\"https:\/\/blexin.com\/wp-content\/uploads\/2020\/12\/image3-5.png 960w, https:\/\/blexin.com\/wp-content\/uploads\/2020\/12\/image3-5-480x189.png 480w\" sizes=\"auto, (min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) 960px, 100vw\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Come possiamo configurare Swagger rendendolo disponibile solo per l&#8217;<em>environment<\/em>\u00a0di sviluppo e disabilitarlo invece per quello di produzione? Ci sono dei semplici passaggi per farlo. Innanzitutto definiamo, nel file\u00a0<em>web.config<\/em>, una nuova\u00a0<em>key<\/em>\u00a0all&#8217;interno del\u00a0<em>tag<\/em>\u00a0&lt;<em>appsettings<\/em>>:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: xml; title: ; notranslate\" title=\"\">\n&lt;appSettings&gt;\n\u00a0\u00a0\u00a0\u00a0&lt;add key=&quot;DisableSwagger&quot; value=&quot;False&quot; \/&gt;\n&lt;\/appSettings&gt;\n<\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">Successivamente, all\u2019interno del file\u00a0<em>SwaggerConfig.cs<\/em>\u00a0ed in particolare all\u2019interno del metodo\u00a0<em>Register()<\/em>, aggiungiamo una controllo sul valore della\u00a0<em>key<\/em>\u00a0definita precendentemente.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: csharp; title: ; notranslate\" title=\"\">\nif (ConfigurationManager.AppSettings&#x5B;&quot;DisableSwagger&quot;] == &quot;True&quot;)\n{\n\u00a0\u00a0\u00a0\u00a0return;\n}\n<\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">Creiamo, quindi, una regola di trasformazione all\u2019interno del\u00a0<em>Web.Release.config<\/em>\u00a0per la quale verr\u00e0 settato il parametro\u00a0<em>DisableSwagger<\/em>\u00a0al valore\u00a0<strong><em>true<\/em><\/strong>\u00a0in modo che la condizione non sia verificata per l&#8217;<em>environment<\/em>\u00a0di produzione.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: csharp; title: ; notranslate\" title=\"\">\n&lt;add key=&quot;DisableSwagger&quot; value=&quot;True&quot; xdt:Transform=&quot;Replace&quot; xdt:Locator=&quot;Match(key)&quot; \/&gt;\n<\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">Possiamo vedere l\u2019effetto di questa trasformazione cliccando col tasto destro su\u00a0<em>Web.Release.config<\/em>\u00a0e selezionando\u00a0<em>\u201cPreview Transform\u201d<\/em><\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" width=\"396\" height=\"328\" data-attachment-id=\"29033\" data-permalink=\"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/attachment\/image4-5\/\" data-orig-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image4-5.png?fit=396%2C328&amp;ssl=1\" data-orig-size=\"396,328\" data-comments-opened=\"0\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"image4-5\" data-image-description=\"\" data-image-caption=\"\" data-large-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image4-5.png?fit=396%2C328&amp;ssl=1\" src=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image4-5.png?resize=396%2C328&#038;ssl=1\" alt=\"\" class=\"wp-image-29033\" srcset=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image4-5.png?w=396&amp;ssl=1 396w, https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image4-5.png?resize=300%2C248&amp;ssl=1 300w\" sizes=\"auto, (max-width: 396px) 100vw, 396px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Otterremo cos\u00ec l&#8217;effetto desiderato:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"68\" data-attachment-id=\"29036\" data-permalink=\"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/attachment\/image5-4\/\" data-orig-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image5-4.png?fit=1380%2C92&amp;ssl=1\" data-orig-size=\"1380,92\" data-comments-opened=\"0\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"image5-4\" data-image-description=\"\" data-image-caption=\"\" data-large-file=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image5-4.png?fit=1024%2C68&amp;ssl=1\" src=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/image5-4.png?resize=1024%2C68&#038;ssl=1\" alt=\"\" class=\"wp-image-29036\" srcset=\"https:\/\/blexin.com\/wp-content\/uploads\/2020\/12\/image5-4-980x65.png 980w, https:\/\/blexin.com\/wp-content\/uploads\/2020\/12\/image5-4-480x32.png 480w\" sizes=\"auto, (min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Semplice e veloce! Spero vi sia utile come lo \u00e8 stato per me.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Alla prossima<\/p>\n\n\n\n\n","protected":false},"excerpt":{"rendered":"<p>Automatizziamo la parte pi\u00f9 noiosa dello sviluppo delle API con Swagger e .Net<\/p>\n","protected":false},"author":196716251,"featured_media":29020,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"off","_et_pb_old_content":"","_et_gb_content_width":"","_coblocks_attr":"","_coblocks_dimensions":"","_coblocks_responsive_height":"","_coblocks_accordion_ie_support":"","inline_featured_image":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_wpcom_ai_launchpad_first_post":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"{title}\n\n{excerpt}\n\n{url}","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"_wpas_customize_per_network":false,"jetpack_post_was_ever_published":false},"categories":[688637374],"tags":[688637446],"class_list":["post-29019","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog","tag-tools"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.4 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Documentare le API con Swagger - Blexin<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/\" \/>\n<meta property=\"og:locale\" content=\"it_IT\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Documentare le API con Swagger - Blexin\" \/>\n<meta property=\"og:description\" content=\"Automatizziamo la parte pi\u00f9 noiosa dello sviluppo delle API con Swagger e .Net\" \/>\n<meta property=\"og:url\" content=\"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/\" \/>\n<meta property=\"og:site_name\" content=\"Blexin\" \/>\n<meta property=\"article:published_time\" content=\"2019-02-18T23:00:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-01-13T08:40:45+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1\" \/>\n\t<meta property=\"og:image:width\" content=\"1024\" \/>\n\t<meta property=\"og:image:height\" content=\"608\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Genny Paudice\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Scritto da\" \/>\n\t<meta name=\"twitter:data1\" content=\"Genny Paudice\" \/>\n\t<meta name=\"twitter:label2\" content=\"Tempo di lettura stimato\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minuti\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/\"},\"author\":{\"name\":\"Genny Paudice\",\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/#\\\/schema\\\/person\\\/ae0e97a3ebb79d2f73e4411c1eb28973\"},\"headline\":\"Documentare le API con Swagger\",\"datePublished\":\"2019-02-18T23:00:00+00:00\",\"dateModified\":\"2021-01-13T08:40:45+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/\"},\"wordCount\":410,\"image\":{\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/i0.wp.com\\\/blexin.com\\\/wp-content\\\/uploads\\\/2020\\\/12\\\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1\",\"keywords\":[\"Tools\"],\"articleSection\":[\"Blog\"],\"inLanguage\":\"it-IT\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/\",\"url\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/\",\"name\":\"Documentare le API con Swagger - Blexin\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/i0.wp.com\\\/blexin.com\\\/wp-content\\\/uploads\\\/2020\\\/12\\\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1\",\"datePublished\":\"2019-02-18T23:00:00+00:00\",\"dateModified\":\"2021-01-13T08:40:45+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/#\\\/schema\\\/person\\\/ae0e97a3ebb79d2f73e4411c1eb28973\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/#breadcrumb\"},\"inLanguage\":\"it-IT\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"it-IT\",\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/#primaryimage\",\"url\":\"https:\\\/\\\/i0.wp.com\\\/blexin.com\\\/wp-content\\\/uploads\\\/2020\\\/12\\\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1\",\"contentUrl\":\"https:\\\/\\\/i0.wp.com\\\/blexin.com\\\/wp-content\\\/uploads\\\/2020\\\/12\\\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1\",\"width\":1024,\"height\":608},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/blog\\\/documentare-le-api-con-swagger\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/blexin.com\\\/it\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentare le API con Swagger\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/#website\",\"url\":\"https:\\\/\\\/blexin.com\\\/it\\\/\",\"name\":\"Blexin\",\"description\":\"Con noi \u00e8 semplice\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/blexin.com\\\/it\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"it-IT\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/blexin.com\\\/it\\\/#\\\/schema\\\/person\\\/ae0e97a3ebb79d2f73e4411c1eb28973\",\"name\":\"Genny Paudice\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"it-IT\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/3093a6ee7b7f555e94e4a5d6f19cb09f3af33635007643b2076eb89329789828?s=96&d=identicon&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/3093a6ee7b7f555e94e4a5d6f19cb09f3af33635007643b2076eb89329789828?s=96&d=identicon&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/3093a6ee7b7f555e94e4a5d6f19cb09f3af33635007643b2076eb89329789828?s=96&d=identicon&r=g\",\"caption\":\"Genny Paudice\"},\"url\":\"https:\\\/\\\/blexin.com\\\/it\\\/author\\\/genny-paudiceblexin-com\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Documentare le API con Swagger - Blexin","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/","og_locale":"it_IT","og_type":"article","og_title":"Documentare le API con Swagger - Blexin","og_description":"Automatizziamo la parte pi\u00f9 noiosa dello sviluppo delle API con Swagger e .Net","og_url":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/","og_site_name":"Blexin","article_published_time":"2019-02-18T23:00:00+00:00","article_modified_time":"2021-01-13T08:40:45+00:00","og_image":[{"width":1024,"height":608,"url":"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1","type":"image\/png"}],"author":"Genny Paudice","twitter_card":"summary_large_image","twitter_misc":{"Scritto da":"Genny Paudice","Tempo di lettura stimato":"3 minuti"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/#article","isPartOf":{"@id":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/"},"author":{"name":"Genny Paudice","@id":"https:\/\/blexin.com\/it\/#\/schema\/person\/ae0e97a3ebb79d2f73e4411c1eb28973"},"headline":"Documentare le API con Swagger","datePublished":"2019-02-18T23:00:00+00:00","dateModified":"2021-01-13T08:40:45+00:00","mainEntityOfPage":{"@id":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/"},"wordCount":410,"image":{"@id":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/#primaryimage"},"thumbnailUrl":"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1","keywords":["Tools"],"articleSection":["Blog"],"inLanguage":"it-IT"},{"@type":"WebPage","@id":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/","url":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/","name":"Documentare le API con Swagger - Blexin","isPartOf":{"@id":"https:\/\/blexin.com\/it\/#website"},"primaryImageOfPage":{"@id":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/#primaryimage"},"image":{"@id":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/#primaryimage"},"thumbnailUrl":"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1","datePublished":"2019-02-18T23:00:00+00:00","dateModified":"2021-01-13T08:40:45+00:00","author":{"@id":"https:\/\/blexin.com\/it\/#\/schema\/person\/ae0e97a3ebb79d2f73e4411c1eb28973"},"breadcrumb":{"@id":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/#breadcrumb"},"inLanguage":"it-IT","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/"]}]},{"@type":"ImageObject","inLanguage":"it-IT","@id":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/#primaryimage","url":"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1","contentUrl":"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1","width":1024,"height":608},{"@type":"BreadcrumbList","@id":"https:\/\/blexin.com\/it\/blog\/documentare-le-api-con-swagger\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/blexin.com\/it\/"},{"@type":"ListItem","position":2,"name":"Documentare le API con Swagger"}]},{"@type":"WebSite","@id":"https:\/\/blexin.com\/it\/#website","url":"https:\/\/blexin.com\/it\/","name":"Blexin","description":"Con noi \u00e8 semplice","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blexin.com\/it\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"it-IT"},{"@type":"Person","@id":"https:\/\/blexin.com\/it\/#\/schema\/person\/ae0e97a3ebb79d2f73e4411c1eb28973","name":"Genny Paudice","image":{"@type":"ImageObject","inLanguage":"it-IT","@id":"https:\/\/secure.gravatar.com\/avatar\/3093a6ee7b7f555e94e4a5d6f19cb09f3af33635007643b2076eb89329789828?s=96&d=identicon&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/3093a6ee7b7f555e94e4a5d6f19cb09f3af33635007643b2076eb89329789828?s=96&d=identicon&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/3093a6ee7b7f555e94e4a5d6f19cb09f3af33635007643b2076eb89329789828?s=96&d=identicon&r=g","caption":"Genny Paudice"},"url":"https:\/\/blexin.com\/it\/author\/genny-paudiceblexin-com\/"}]}},"jetpack_publicize_connections":[],"jetpack_shortlink":"https:\/\/wp.me\/pcyUBx-7y3","jetpack_sharing_enabled":true,"jetpack_featured_media_url":"https:\/\/i0.wp.com\/blexin.com\/wp-content\/uploads\/2020\/12\/208a28b8-de1f-4321-b877-f7ca01ccaea6.png?fit=1024%2C608&ssl=1","_links":{"self":[{"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/posts\/29019","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/users\/196716251"}],"replies":[{"embeddable":true,"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/comments?post=29019"}],"version-history":[{"count":6,"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/posts\/29019\/revisions"}],"predecessor-version":[{"id":29038,"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/posts\/29019\/revisions\/29038"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/media\/29020"}],"wp:attachment":[{"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/media?parent=29019"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/categories?post=29019"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blexin.com\/it\/wp-json\/wp\/v2\/tags?post=29019"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}