<?xml version="1.0" encoding="utf-8" ?>
<rss version="2.0" xml:base="https://www.programmez.com/" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>OpenAPI</title>
    <link>https://www.programmez.com/</link>
    <description></description>
    <language>fr</language>
    
    <item>
  <title>OpenAPI Comment Parser : un outil IBM pour analyser les commentaires dans le code d&#039;une API et générer la documentation correspondante</title>
  <link>https://www.programmez.com/actualites/openapi-comment-parser-un-outil-ibm-pour-analyser-les-commentaires-dans-le-code-dune-api-et-generer-30964</link>
  <description>&lt;span class=&quot;field field--name-title field--type-string field--label-hidden&quot;&gt;OpenAPI Comment Parser : un outil IBM pour analyser les commentaires dans le code d&amp;#039;une API et générer la documentation correspondante&lt;/span&gt;
&lt;span class=&quot;field field--name-uid field--type-entity-reference field--label-hidden&quot;&gt;&lt;span&gt;fredericmazue&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;field field--name-created field--type-created field--label-hidden&quot;&gt;&lt;time datetime=&quot;2020-10-02T16:43:34+02:00&quot; title=&quot;Vendredi, 2 octobre 2020 - 16:43&quot; class=&quot;datetime&quot;&gt;ven, 2 Oct 2020 - 16:43&lt;/time&gt;
&lt;/span&gt;


  &lt;div class=&quot;inline__links&quot;&gt;&lt;nav class=&quot;links inline nav links-inline&quot;&gt;&lt;span class=&quot;comment-forbidden nav-link&quot;&gt;&lt;a href=&quot;/user/login?destination=/actualites/openapi-comment-parser-un-outil-ibm-pour-analyser-les-commentaires-dans-le-code-dune-api-et-generer-30964%23comment-form&quot;&gt;Se connecter&lt;/a&gt; ou &lt;a href=&quot;/user/register?destination=/actualites/openapi-comment-parser-un-outil-ibm-pour-analyser-les-commentaires-dans-le-code-dune-api-et-generer-30964%23comment-form&quot;&gt;s&#039;inscrire&lt;/a&gt; pour publier un commentaire&lt;/span&gt;&lt;/nav&gt;
  &lt;/div&gt;

&lt;div class=&quot;btn btn-light&quot;&gt;
      &lt;a href=&quot;/actualites/outils&quot; hreflang=&quot;fr&quot;&gt;Outils&lt;/a&gt;
  &lt;/div&gt;

&lt;div class=&quot;mots-cles-actualite d-flex flex-wrap gap-2&quot;&gt;
      &lt;div class=&quot;btn&quot;&gt;&lt;a href=&quot;/actualites/documentation&quot; hreflang=&quot;fr&quot;&gt;Documentation&lt;/a&gt;&lt;/div&gt;
      &lt;div class=&quot;btn&quot;&gt;&lt;a href=&quot;/actualites/openapi&quot; hreflang=&quot;fr&quot;&gt;OpenAPI&lt;/a&gt;&lt;/div&gt;
  &lt;/div&gt;

            &lt;div class=&quot;clearfix text-formatted field field--name-body field--type-text-with-summary field--label-hidden field__item&quot;&gt;&lt;p&gt;Les développeurs ont besoin d&#039;instructions sur la façon d&#039;utiliser une API et ils ont besoin d&#039;un moyen de l&#039;essayer.&amp;nbsp;Une bonne documentation satisfait ces deux besoins. Pour aider à générer une telle documentation, conforme aux spécifications OpenAPI, IBM propose OpenAPI Comment Parser&lt;/p&gt;
&lt;p&gt;OpenAPI Comment Parser a pour objectif de donner aux développeurs d&#039;API un moyen de générer une documentation conforme aux spécifications OpenAPI à partir de commentaires en ligne dans leur code.&amp;nbsp;&lt;em&gt;Lorsque la spécification OpenAPI vit dans le code, les développeurs sont beaucoup plus susceptibles de la maintenir à jour à mesure que leur code change&lt;/em&gt;, souligne IBM.&lt;/p&gt;
&lt;p&gt;OpenAPI Comment Parser est une bibliothèque est conçue pour Node.js, mais elle peut fonctionner avec n&#039;importe quel langage qui utilise ce style de commentaires:&lt;/p&gt;
&lt;p&gt;/**&lt;br&gt; * GET /users/{userId}&lt;br&gt; * @summary Returns a user by ID.&lt;br&gt;* @pathParam {int64} userId - The user&#039;s ID.&lt;br&gt; * @response 200 - OK&lt;br&gt; */&lt;/p&gt;
&lt;p&gt;OpenAPI Comment Parser est un logiciel libre sous licence Apache 2.0, disponivle sur &lt;a href=&quot;https://github.com/bee-travels/openapi-comment-parser&quot;&gt;GitHub&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;[video:https://www.youtube.com/watch?v=-Z9Zn8RHf0c autoplay:0]&lt;/p&gt;
&lt;/div&gt;
      &lt;section class=&quot;field field--name-field-commentaire-actu field--type-comment field--label-above comment-wrapper&quot;&gt;
  
  

  
&lt;/section&gt;
</description>
  <pubDate>Fri, 02 Oct 2020 14:43:34 +0000</pubDate>
    <dc:creator>fredericmazue</dc:creator>
    <guid isPermaLink="false">73559 at https://www.programmez.com</guid>
    </item>
<item>
  <title>GitHub ouvre une description OpenAPI de son API REST</title>
  <link>https://www.programmez.com/actualites/github-ouvre-une-description-openapi-de-son-api-rest-30827</link>
  <description>&lt;span class=&quot;field field--name-title field--type-string field--label-hidden&quot;&gt;GitHub ouvre une description OpenAPI de son API REST&lt;/span&gt;
&lt;span class=&quot;field field--name-uid field--type-entity-reference field--label-hidden&quot;&gt;&lt;span&gt;fredericmazue&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;field field--name-created field--type-created field--label-hidden&quot;&gt;&lt;time datetime=&quot;2020-08-26T11:48:40+02:00&quot; title=&quot;Mercredi, 26 août 2020 - 11:48&quot; class=&quot;datetime&quot;&gt;mer, 26 Aoû 2020 - 11:48&lt;/time&gt;
&lt;/span&gt;


  &lt;div class=&quot;inline__links&quot;&gt;&lt;nav class=&quot;links inline nav links-inline&quot;&gt;&lt;span class=&quot;comment-forbidden nav-link&quot;&gt;&lt;a href=&quot;/user/login?destination=/actualites/github-ouvre-une-description-openapi-de-son-api-rest-30827%23comment-form&quot;&gt;Se connecter&lt;/a&gt; ou &lt;a href=&quot;/user/register?destination=/actualites/github-ouvre-une-description-openapi-de-son-api-rest-30827%23comment-form&quot;&gt;s&#039;inscrire&lt;/a&gt; pour publier un commentaire&lt;/span&gt;&lt;/nav&gt;
  &lt;/div&gt;

&lt;div class=&quot;btn btn-light&quot;&gt;
      &lt;a href=&quot;/actualites/outils/frameworks&quot; hreflang=&quot;fr&quot;&gt;Frameworks&lt;/a&gt;
  &lt;/div&gt;

&lt;div class=&quot;mots-cles-actualite d-flex flex-wrap gap-2&quot;&gt;
      &lt;div class=&quot;btn&quot;&gt;&lt;a href=&quot;/actualites/openapi&quot; hreflang=&quot;fr&quot;&gt;OpenAPI&lt;/a&gt;&lt;/div&gt;
      &lt;div class=&quot;btn&quot;&gt;&lt;a href=&quot;/actualites/github&quot; hreflang=&quot;fr&quot;&gt;GitHub&lt;/a&gt;&lt;/div&gt;
      &lt;div class=&quot;btn&quot;&gt;&lt;a href=&quot;/actualites/api-rest&quot; hreflang=&quot;fr&quot;&gt;API REST&lt;/a&gt;&lt;/div&gt;
  &lt;/div&gt;

            &lt;div class=&quot;clearfix text-formatted field field--name-body field--type-text-with-summary field--label-hidden field__item&quot;&gt;&lt;p&gt;Afin d&#039;améliorer la façon dont les développeurs peuvent interagir avec son API REST, GitHub a ouvert une&amp;nbsp;description OpenAPI&amp;nbsp;de celle-ci.&lt;/p&gt;
&lt;p&gt;Pour mémoire, la spécification OpenAPI (OAS) définit une description d&#039;interface standard, indépendante du langage de programmation pour les API HTTP. &amp;nbsp;Cette description d&#039;interface permet aux humains et aux ordinateurs de découvrir et de comprendre les capacités d&#039;un service sans avoir besoin d&#039;accéder au code source, à une documentation supplémentaire ou à l&#039;inspection du trafic réseau.&amp;nbsp;Grâce à une telle description, un consommateur peut comprendre et interagir avec le service distant avec un minimum de logique d&#039;implémentation.&lt;/p&gt;
&lt;p&gt;La description GitHub OpenAPI contient plus de 600 opérations exposées par l&#039;API REST. Pour l&#039;exploration visuelle de l&#039;API, vous pouvez charger la description en tant que&amp;nbsp;&lt;a href=&quot;https://www.postman.com/collection/&quot;&gt;collection Postman&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Cette description est actuellement en phase bêta. &lt;em&gt;Décrire une API vieille de 12 ans n&#039;est pas une tâche facile&lt;/em&gt;, souligne GitHub&lt;/p&gt;
&lt;p&gt;La description OpenAPI de l&#039;API REST GitHub est un logiciel libre sous licence MIT, disponible sur ... &lt;a href=&quot;https://github.com/github/rest-api-description&quot;&gt;GitHub&lt;/a&gt; :-)&lt;/p&gt;
&lt;/div&gt;
      &lt;section class=&quot;field field--name-field-commentaire-actu field--type-comment field--label-above comment-wrapper&quot;&gt;
  
  

  
&lt;/section&gt;
</description>
  <pubDate>Wed, 26 Aug 2020 09:48:40 +0000</pubDate>
    <dc:creator>fredericmazue</dc:creator>
    <guid isPermaLink="false">73458 at https://www.programmez.com</guid>
    </item>

  </channel>
</rss>
