{"id":15270,"date":"2024-07-09T09:45:48","date_gmt":"2024-07-09T07:45:48","guid":{"rendered":"https:\/\/blog.ouidou.fr\/?p=15270"},"modified":"2024-09-03T15:29:20","modified_gmt":"2024-09-03T13:29:20","slug":"creer-une-api-rest-en-go","status":"publish","type":"post","link":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go","title":{"rendered":"Cr\u00e9er une API REST en Go"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\"><em>Article \u00e9crit par Etienne R<\/em>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pour cr\u00e9er une API Rest en Go, il existe de nombreux frameworks dit \u201chttp\u201d d\u00e9di\u00e9s. C\u2019est un framework qui g\u00e8re les routes HTTP (Get, Post, Update, Patch, Delete, etc\u2026) et qui retourne des donn\u00e9es au format JSON, XML, HTML, etc\u2026 Il en existe plusieurs dans l&rsquo;\u00e9co-syst\u00e8me de Go tels que Gorilla, Beego, Iris, Echo, Fiber, etc\u2026 De notre cot\u00e9, nous allons partir sur Gin. Qui dit API, dit base de donn\u00e9es. Pour effectuer les requ\u00eates SQL, nous allons utiliser un ORM afin de faciliter la communication avec la base de donn\u00e9es. Pour cela, nous allons utiliser Gorm avec SQLite (pour les besoins de la d\u00e9mo car il est conseill\u00e9 d\u2019utiliser une base de donn\u00e9es comme Postgres ou MariaDB en production).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Pr\u00e9-requis<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Avoir Go install\u00e9 et configur\u00e9 sur votre environnement de d\u00e9veloppement avec la commande go version.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Remarque : cet article a \u00e9t\u00e9 r\u00e9alis\u00e9 avec la version de Go 1.22.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Optionnel : pour le d\u00e9veloppement, utilisez la librairie Air qui permet de reconstruire l\u2019application \u00e0 la vol\u00e9e lors de la modification d\u2019un fichier et \u00e9vite de le faire manuellement (\u00e0 l\u2019image de Nodemon sur Node).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#pr%C3%A9paratifs\"><\/a>Pr\u00e9paratifs<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Dans le r\u00e9pertoire de votre future application, g\u00e9n\u00e9rer le fichier de package \u201cgo.mod\u201d avec la commande ci-dessous.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"\">$ go mod init demo-api-gin\ngo: creating new go.mod: module demo-api-gin<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Puis les 3 paquets mentionn\u00e9s pr\u00e9c\u00e9demment.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"\">go get github.com\/gin-gonic\/gin\ngo get \"gorm.io\/gorm\"\ngo get \"gorm.io\/driver\/sqlite\"\n<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Mod\u00e8le<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Cr\u00e9ez un dossier <code>models<\/code> avec un nouveau fichier <code>articles.go<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Structure<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"\">\/\/ models\/articles.go\n\npackage models\n\nimport (\n    \"gorm.io\/gorm\"\n)\n\n\/\/ Structure de la table\ntype Articles struct {\n    Id          uint   `gorm:\"AUTO_INCREMENT\" json:\"id\"`\n    Title       string `gorm:\"not null\" json:\"title\" binding:\"required\"`\n    Description string `gorm:\"not null\" json:\"description\" binding:\"required\"`\n}\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">On d\u00e9clare la structure de notre mod\u00e8le d\u2019article avec 3 champs <code>Id<\/code>, <code>Title<\/code> et <code>Description<\/code>. On d\u00e9clare \u00e9galement que les 2 derniers champs sont obligatoires.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Remarque : Gin utilise la librairie Go Validator avec le mot clef <code>binding<\/code> dans les options de <code>Struct<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Ajouter ou modifier un article<\/h3>\n\n\n\n<pre id=\"code-53\" class=\"wp-block-code\"><code class=\"\">func (article *Articles) SaveOrUpdateArticle(db *gorm.DB) error {\n    return db.Model(&amp;article).Save(article).Error\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Avec la fonction <code>Save<\/code> de Gorm, on peut ajouter ou mettre \u00e0 jour une ligne d&rsquo;article.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#trouver-tous-les-articles\"><\/a>Trouver tous les articles<\/h3>\n\n\n\n<pre id=\"code-54\" class=\"wp-block-code\"><code class=\"\">func (article *Articles) FindArticles(db *gorm.DB) (*[]Articles, error) {\n    var articles []Articles\n    err := db.Find(&amp;articles).Error\n    return &amp;articles, err\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Avec la fonction <code>Find<\/code> de Gorm, on peut obtenir la liste de tous les articles.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#trouver-un-article-via-son-id\"><\/a>Trouver un article via son id<\/h3>\n\n\n\n<pre id=\"code-55\" class=\"wp-block-code\"><code class=\"\">func (articles *Articles) FindArticle(db *gorm.DB, id string) (*Articles, error) {\n    var article Articles\n    err := db.Take(&amp;article, id).Error\n    return &amp;article, err\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Avec la fonction <code>Take<\/code> de Gorm, on peut obtenir la ligne d\u2019un article en fonction de son id.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#supprimer-un-article\"><\/a>Supprimer un article<\/h3>\n\n\n\n<pre id=\"code-56\" class=\"wp-block-code\"><code class=\"\">func (article *Articles) RemoveArticle(db *gorm.DB, id string) error {\n    return db.Delete(&amp;article).Error\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Avec la fonction <code>Delete<\/code> de Gorm, on peut supprimer une ligne d&rsquo;article en fonction de son id.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#contr%C3%B4leurs-crud-create-read-update-delete\"><\/a>Contr\u00f4leurs CRUD (Create Read Update Delete)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Cr\u00e9ez un dossier <code>controllers<\/code> avec un nouveau fichier <code>articles.go<\/code>.<\/p>\n\n\n\n<pre id=\"code-57\" class=\"wp-block-code\"><code class=\"\">\/\/ controllers\/articles.go\n\npackage controllers\n\nimport (\n    \"demo-api-gin\/models\"\n\n    \"github.com\/gin-gonic\/gin\"\n    \"gorm.io\/gorm\"\n)\n\ntype ArticlesRepo struct {\n    Db *gorm.DB\n}\n\nfunc error500(c *gin.Context) {\n    c.JSON(500, gin.H{\"error\": \"Something wrong\"})\n}\n\nfunc error404(c *gin.Context) {\n    c.JSON(404, gin.H{\"error\": \"Article not found\"})\n}\n\n\/\/ Ajouter un article\nfunc (repository *ArticlesRepo) PostArticles(c *gin.Context) {\n}\n\n\/\/ Obtenir la liste de tous les articles\nfunc (repository *ArticlesRepo) GetArticles(c *gin.Context) {\n}\n\n\/\/ Obtenir un seul article via son id\nfunc (repository *ArticlesRepo) GetArticle(c *gin.Context) {\n}\n\n\/\/ Modifier un article via son id\nfunc (repository *ArticlesRepo) EditArticle(c *gin.Context) {\n}\n\n\/\/ Supprimer un article\nfunc (repository *ArticlesRepo) DeleteArticle(c *gin.Context) {\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">On appel la structure de Gorm et les 2 messages g\u00e9n\u00e9riques pour les erreurs 500 et 404 (afin d&rsquo;\u00e9viter de la duplication de code). Et on met en place nos 5 contr\u00f4leurs que nous allons remplir.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#ajouter-un-article\"><\/a>Ajouter un article<\/h3>\n\n\n\n<pre id=\"code-58\" class=\"wp-block-code\"><code class=\"\">func (repository *ArticlesRepo) PostArticles(c *gin.Context) {\n    var articleModel models.Articles\n\n    if err := c.ShouldBindJSON(&amp;articleModel); err != nil {\n        c.JSON(422, gin.H{\"error\": err.Error()})\n        return\n    }\n\n    if err := articleModel.SaveOrUpdateArticle(repository.Db); err != nil {\n        error500(c)\n        return\n    }\n\n    c.JSON(201, gin.H{\"success\": articleModel})\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">On d\u00e9clare une variable nomm\u00e9e <code>articleModel<\/code> au format de la structure <code>Articles<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">On v\u00e9rifie que les valeurs des champs <code>title<\/code> et <code>description<\/code> ne sont pas vides avec la fonction <code>ShouldBindJSON<\/code>. Si les 2 champs sont mal renseign\u00e9s, on retourne une erreur HTTP 422.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">On appel la fonction d\u00e9di\u00e9e dans le mod\u00e8le, c\u2019est-\u00e0-dire <code>SaveOrUpdateArticle<\/code>. Si tout va bien, on ajoute les valeurs en BDD et on retourne le code HTTP 201 avec un message de succ\u00e8s sinon on retourne une erreur g\u00e9n\u00e9rique avec le code HTTP 500.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#obtenir-la-liste-de-tous-les-articles\"><\/a>Obtenir la liste de tous les articles<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"\">func (repository *ArticlesRepo) GetArticles(c *gin.Context) {\n    var articleModel models.Articles\n    articles, err := articleModel.FindArticles(repository.Db)\n\n    if err != nil {\n        error500(c)\n        return\n    }\n\n    c.JSON(200, articles)\n}\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">On d\u00e9clare une variable nomm\u00e9e <code>articleModel<\/code> au format de la structure <code>Articles<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">On appel la fonction d\u00e9di\u00e9e dans le mod\u00e8le, c\u2019est-\u00e0-dire <code>FindArticles<\/code>. Si tout va bien, on ajoute les valeurs en BDD et on retourne le code HTTP 200 avec le JSON contenant la liste des articles sinon on retourne une erreur g\u00e9n\u00e9rique avec le code HTTP 500.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Obtenir un seul article via son id<\/h3>\n\n\n\n<pre id=\"code-60\" class=\"wp-block-code\"><code class=\"\">func (repository *ArticlesRepo) GetArticle(c *gin.Context) {\n    id := c.Params.ByName(\"id\")\n    var articleModel models.Articles\n    article, err := articleModel.FindArticle(repository.Db, id)\n\n    if article.Id == 0 {\n        error404(c)\n        return\n    }\n\n    if err != nil {\n        error500(c)\n        return\n    }\n\n    c.JSON(200, article)\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">On r\u00e9cup\u00e8re l\u2019id dans une variable du m\u00eame nom.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">On d\u00e9finit l\u2019article dans une variable <code>articleModel<\/code> au format de la structure <code>Articles<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">On appel la fonction d\u00e9di\u00e9e dans le mod\u00e8le, c\u2019est-\u00e0-dire <code>FindArticle<\/code> avec l\u2019id d\u00e9sir\u00e9 en param\u00e8tre. Dans un premier temps, on v\u00e9rifie que si l\u2019article n\u2019existe pas ou plus, on retourne une erreur avec code HTTP 404. Puis on v\u00e9rifie que si il y a une erreur avec la requ\u00eate SQL, on retourne une erreur g\u00e9n\u00e9rique avec le code HTTP 500. Si tout va bien, on le JSON de l\u2019article en 200.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#modifier-un-article-via-son-id\"><\/a>Modifier un article via son id<\/h3>\n\n\n\n<pre id=\"code-61\" class=\"wp-block-code\"><code class=\"\">func (repository *ArticlesRepo) EditArticle(c *gin.Context) {\n    id := c.Params.ByName(\"id\")\n    var articleModel models.Articles\n    article, err := articleModel.FindArticle(repository.Db, id)\n\n    if article.Id == 0 {\n        error404(c)\n        return\n    }\n\n    if err := c.ShouldBindJSON(&amp;article); err != nil {\n        c.JSON(422, gin.H{\"error\": err.Error()})\n        return\n    }\n\n    if err != nil {\n        error500(c)\n        return\n    }\n\n    if err = articleModel.SaveOrUpdateArticle(repository.Db); err != nil {\n        error500(c)\n        return\n    }\n\n    c.JSON(200, gin.H{\"success\": article})\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">On fait comme dans la requ\u00eate pr\u00e9c\u00e9dente sauf que l\u2019on appel par la suite, la fonction d\u00e9di\u00e9e dans le mod\u00e8le, c\u2019est-\u00e0-dire <code>SaveOrUpdateArticle<\/code> et on reprend le m\u00eame principe que l\u2019ajout d\u2019un article (sauf pour le code HTTP qui est en 200).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Supprimer un article via son id<\/h3>\n\n\n\n<pre id=\"code-62\" class=\"wp-block-code\"><code class=\"\">func (repository *ArticlesRepo) DeleteArticle(c *gin.Context) {\n    id := c.Params.ByName(\"id\")\n    var articleModel models.Articles\n    _, err := articleModel.FindArticle(repository.Db, id)\n\n    if err != nil {\n        error404(c)\n        return\n    }\n\n    if err := articleModel.RemoveArticle(repository.Db, id); err == nil {\n        error500(c)\n        return\n    }\n\n    c.JSON(200, gin.H{\"success\": \"Article #\" + id + \" deleted\"})\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">On r\u00e9cup\u00e8re l\u2019id dans une variable du m\u00eame nom.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">On d\u00e9finit l\u2019article dans une variable <code>articleModel<\/code> au format de la structure \u201cArticles.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">On appel la fonction d\u00e9di\u00e9e dans le mod\u00e8le, c\u2019est-\u00e0-dire <code>FindArticle<\/code> avec l\u2019id en param\u00e8tre. Dans un premier temps, on v\u00e9rifie que si l\u2019article n\u2019existe pas, on retourne une erreur avec code HTTP 404. Puis on v\u00e9rifie que si y a une erreur avec la requ\u00eate SQL, on retourne une erreur g\u00e9n\u00e9rique avec le code HTTP 500. Si tout va bien, on retourne une 200 avec le JSON de l\u2019article.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#routes\"><\/a>Routes<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Cr\u00e9ez un dossier <code>routes<\/code> avec un nouveau <code>fichier articles.go<\/code>.<\/p>\n\n\n\n<pre id=\"code-63\" class=\"wp-block-code\"><code class=\"\">\/\/ routes\/articles.go\n\npackage routes\n\nimport (\n    \"demo-api-gin\/controllers\"\n\n    \"github.com\/gin-gonic\/gin\"\n    \"gorm.io\/gorm\"\n)\n\nfunc ArticlesRoutes(r *gin.Engine, db *gorm.DB) *gin.Engine {\n    articlesRepo := controllers.ArticlesRepo{\n        Db: db,\n    }\n\n    v1Articles := r.Group(\"api\/v1\/articles\")\n    {\n        v1Articles.POST(\"\", articlesRepo.PostArticles)\n        v1Articles.GET(\"\", articlesRepo.GetArticles)\n        v1Articles.GET(\":id\", articlesRepo.GetArticle)\n        v1Articles.PUT(\":id\", articlesRepo.EditArticle)\n        v1Articles.DELETE(\":id\", articlesRepo.DeleteArticle)\n    }\n\n    return r\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">On regroupe nos 5 requ\u00eates dans une m\u00eame variable via la fonction <code>Group<\/code> de Gin. afin de pouvoir pr\u00e9fixer le chemin de chaque endpoint.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#connexion-%C3%A0-la-base-de-donn%C3%A9es\"><\/a>Connexion \u00e0 la base de donn\u00e9es<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Cr\u00e9ez un dossier <code>db<\/code> avec un nouveau fichier <code>db.go<\/code>.<\/p>\n\n\n\n<pre id=\"code-64\" class=\"wp-block-code\"><code class=\"\">\/\/ db\/db.go\n\npackage db\n\nimport (\n    \"gorm.io\/driver\/sqlite\"\n    \"gorm.io\/gorm\"\n\n    \"demo-api-gin\/models\"\n)\n\nfunc InitDb() *gorm.DB {\n    db, err := gorm.Open(sqlite.Open(\"api.db\"), &amp;gorm.Config{})\n\n    if err != nil {\n        panic(\"Failed to connect database\")\n    }\n\n    db.AutoMigrate(&amp;models.Articles{})\n\n    return db\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Dans la fonction <code>InitDb<\/code>, on instancie une connexion avec le fichier SQLite <code>api.db<\/code>. En cas d\u2019erreur, le programme sera interrompu par un <code>panic<\/code>. L\u2019ORM cr\u00e9\u00e9 tout seul la table <code>Articles<\/code> via la fonction <code>AutoMigrate<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#point-dentr%C3%A9e\"><\/a>Point d\u2019entr\u00e9e<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A la racine du projet, ajoutez le fichier d\u2019entr\u00e9e, <code>main.go<\/code> avec le code ci-dessous.<\/p>\n\n\n\n<pre id=\"code-65\" class=\"wp-block-code\"><code class=\"\">package main\n\nimport \"demo-api-gin\/api\"\n\nfunc main() {\n    err := http.ListenAndServe(\":3000\", api.Handlers())\n\n    if err != nil {\n        log.Fatal(\"ListenAndServe: \", err)\n    }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">La fonction principale <code>main<\/code>, va chercher la fonction <code>Handlers()<\/code> pr\u00e9sente dans le fichier <code>api.go<\/code> et instancier le serveur de Gin sur le port 3000.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Tests et taux de couverture<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Tester manuellement les routes, c\u2019est assez chronophage. Pour la prosp\u00e9rit\u00e9, nous allons les tester. Pour ce faire, nous allons utiliser la librairie officielle <code>net\/http\/httptest<\/code> ainsi que <code>testify<\/code> pour les assertions. Ci-dessous, le tableau r\u00e9capitulatif des sc\u00e9narios \u00e0 tester.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Type de requ\u00e8te<\/th><th>URL<\/th><th>Code attendu<\/th><\/tr><\/thead><tbody><tr><td>GET<\/td><td>\/articles<\/td><td>200<\/td><\/tr><tr><td>GET<\/td><td>\/articles\/42<\/td><td>404<\/td><\/tr><tr><td>GET<\/td><td>\/articles\/1<\/td><td>200<\/td><\/tr><tr><td>POST<\/td><td>\/articles<\/td><td>422<\/td><\/tr><tr><td>POST<\/td><td>\/articles<\/td><td>201<\/td><\/tr><tr><td>PUT<\/td><td>\/articles\/42<\/td><td>404<\/td><\/tr><tr><td>PUT<\/td><td>\/articles\/1<\/td><td>422<\/td><\/tr><tr><td>PUT<\/td><td>\/articles\/1<\/td><td>200<\/td><\/tr><tr><td>DELETE<\/td><td>\/article\/42<\/td><td>404<\/td><\/tr><tr><td>DELETE<\/td><td>\/articles\/1<\/td><td>200<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#pr%C3%A9paratifs-1\"><\/a>Pr\u00e9paratifs<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Installez la librairie testify pour retourner des assertions <code>go get github.com\/stretchr\/testify\/assert<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Dans le r\u00e9pertoire <code>controllers<\/code>, cr\u00e9ez un nouveau fichier <code>articles_test.go<\/code>.<\/p>\n\n\n\n<pre id=\"code-66\" class=\"wp-block-code\"><code class=\"\">\/\/ controllers\/articles_test.go\n\npackage controllers_test\n\nimport (\n    \"demo-api-gin\/api\"\n    \"demo-api-gin\/db\"\n    \"demo-api-gin\/models\"\n    \"net\/http\"\n    \"net\/http\/httptest\"\n    \"strings\"\n    \"testing\"\n\n    \"github.com\/stretchr\/testify\/assert\"\n)\n\nvar baseUrl = \"\/api\/v1\/articles\"\nvar messageNotFound = `{\"error\":\"Article not found\"}`\nvar messageMissingFields = `{\"error\":\"invalid request\"}`\n\nfunc init() {\n    db := db.InitDb()\n\n    var article models.Articles\n\n    db.Migrator().DropTable(article)\n    db.Migrator().CreateTable(article)\n\n    articles := []models.Articles{{\n        Title: \"Titre 1\", Description: \"Description 1\",\n    }, {\n        Title: \"Titre 2\", Description: \"Description 2\",\n    }}\n\n    db.Save(articles)\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">On importe les librairies puis on d\u00e9clare 3 variables dont la premi\u00e8re pour avoir la base de l\u2019URL et les autres pour afficher des messages d\u2019erreur g\u00e9n\u00e9riques. Le plus important se situe dans la fonction \u201cinit\u201d car c\u2019est le d\u00e9roulement de chaque test. Une base de donn\u00e9es est instanci\u00e9e (un fichier <code>api.db<\/code> sera instanci\u00e9 dans le dossier <code>api<\/code>). Par d\u00e9faut, la table <code>articles<\/code> sera supprim\u00e9e afin d&rsquo;\u00e9viter tout conflit avec la fonction de Gorm <code>DropTable<\/code>. Puis la cr\u00e9ation de la table <code>articles<\/code> avec la fonction de Gorm <code>CreateTable<\/code>. Cette table est aliment\u00e9e de 2 lignes d\u2019aticles avec la fonction de Gorm <code>Save<\/code>. Avant de commencer nos tests, on met \u00e9galement en place une fonction pour appeler le routeur.<\/p>\n\n\n\n<pre id=\"code-67\" class=\"wp-block-code\"><code class=\"\">func setRouter(method string, uri string, body *strings.Reader) *httptest.ResponseRecorder {\n    router := api.Handlers()\n    w := httptest.NewRecorder()\n\n    if body == nil {\n        req, _ := http.NewRequest(method, uri, nil)\n        router.ServeHTTP(w, req)\n\n        return w\n    }\n\n    req, _ := http.NewRequest(method, uri, body)\n    router.ServeHTTP(w, req)\n\n    return w\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#tester-get-en-200\"><\/a>Tester GET en 200<\/h3>\n\n\n\n<pre id=\"code-68\" class=\"wp-block-code\"><code class=\"\">func TestGetArticles(t *testing.T) {\n    t.Run(\"GET articles - 200\", func(t *testing.T) {\n        w := setRouter(\"GET\", baseUrl, nil)\n\n        assert.Equal(t, 200, w.Code)\n        assert.Equal(t, `[{\"id\":1,\"title\":\"Titre 1\",\"description\":\"Description 1\"},{\"id\":2,\"title\":\"Titre 2\",\"description\":\"Description 2\"}]`, w.Body.String())\n    })\n}<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type GET sur l\u2019url <code>\/api\/v1\/articles<\/code> ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 200 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un tableau de JSON avec la liste des articles mock\u00e9s dans la fonction <code>init<\/code>.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Tester GET \/id en 200 et 404<\/h3>\n\n\n\n<pre id=\"code-69\" class=\"wp-block-code\"><code class=\"\">func TestGetArticle(t *testing.T) {\n    t.Run(\"GET article - 404\", func(t *testing.T) {\n        w := setRouter(\"GET\", baseUrl+\"\/42\", nil)\n\n        assert.Equal(t, 404, w.Code)\n        assert.Equal(t, messageNotFound, w.Body.String())\n    })\n\n    t.Run(\"GET article - 200\", func(t *testing.T) {\n        w := setRouter(\"GET\", baseUrl+\"\/1\", nil)\n\n        assert.Equal(t, 200, w.Code)\n        assert.Equal(t, `{\"id\":1,\"title\":\"Titre 1\",\"description\":\"Description 1\"}`, w.Body.String())\n    })\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Premier test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type GET sur l\u2019url <code>\/api\/v1\/articles\/42<\/code> ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 400 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir le message d\u2019erreur g\u00e9n\u00e9rique d\u00e9di\u00e9.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Second test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type GET sur l\u2019url <code>\/api\/v1\/articles\/1<\/code> ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 200 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir une ligne de JSON mock\u00e9e dans la fonction <code>init<\/code>.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#tester-post-en-422-et-en-200\"><\/a>Tester POST en 422 et en 200<\/h3>\n\n\n\n<pre id=\"code-70\" class=\"wp-block-code\"><code class=\"\">func TestPostArticle(t *testing.T) {\n    t.Run(\"POST article - 422\", func(t *testing.T) {\n        newArticle := strings.NewReader(`{\"title\":\"Titre 3\",\"description\":\"\"}`)\n        w := setRouter(\"POST\", baseUrl, newArticle)\n\n        assert.Equal(t, 422, w.Code)\n        assert.Equal(t, `{\"error\":\"Key: 'Articles.Description' Error:Field validation for 'Description' failed on the 'required' tag\"}`, w.Body.String())\n    })\n\n    t.Run(\"POST article - 201\", func(t *testing.T) {\n        newArticle := strings.NewReader(`{\"title\":\"Titre 3\",\"description\":\"Description 3\"}`)\n        w := setRouter(\"POST\", baseUrl, newArticle)\n\n        assert.Equal(t, 201, w.Code)\n        assert.Equal(t, `{\"success\":{\"id\":3,\"title\":\"Titre 3\",\"description\":\"Description 3\"}}`, w.Body.String())\n    })\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Premier test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type POST sur l\u2019url <code>\/api\/v1\/articles<\/code> avec un contenu en JSON erron\u00e9;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 422 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir le message d\u2019erreur g\u00e9n\u00e9rique d\u00e9di\u00e9.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Second test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type POST sur l\u2019url <code>\/api\/v1\/articles<\/code> ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 200 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir le message de succ\u00e8s attendu.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Tester PUT en 404, 422 et 200<\/h3>\n\n\n\n<pre id=\"code-71\" class=\"wp-block-code\"><code class=\"\">func TestEditArticle(t *testing.T) {\n    article := strings.NewReader(`{\"title\":\"Titre test\",\"description\":\"Description test\"}`)\n\n    t.Run(\"PUT article - 404\", func(t *testing.T) {\n        w := setRouter(\"PUT\", baseUrl+\"\/42\", article)\n\n        assert.Equal(t, 404, w.Code)\n        assert.Equal(t, messageNotFound, w.Body.String())\n    })\n\n    t.Run(\"PUT article - 422\", func(t *testing.T) {\n        w := setRouter(\"PUT\", baseUrl+\"\/1\", nil)\n\n        assert.Equal(t, 422, w.Code)\n        assert.Equal(t, messageMissingFields, w.Body.String())\n    })\n\n    t.Run(\"PUT article - 200\", func(t *testing.T) {\n        w := setRouter(\"PUT\", baseUrl+\"\/1\", article)\n\n        assert.Equal(t, 200, w.Code)\n        assert.Equal(t, `{\"success\":{\"id\":1,\"title\":\"Titre test\",\"description\":\"Description test\"}}`, w.Body.String())\n    })\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Premier test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type PUT sur l\u2019url <code>\/api\/v1\/articles\/42<\/code><\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 404 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir le message d\u2019erreur g\u00e9n\u00e9rique d\u00e9di\u00e9.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Second test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type PUT sur l\u2019url <code>\/api\/v1\/articles1<\/code> avec du contenu erron\u00e9 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 422 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir le message d\u2019erreur g\u00e9n\u00e9rique d\u00e9di\u00e9.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Troisi\u00e8me test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type PUT sur l\u2019url <code>\/api\/v1\/articles1<\/code> avec du contenu erron\u00e9 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 200 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir le message de succ\u00e8s attendu.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Tester DELETE en 404 et 200<\/h3>\n\n\n\n<pre id=\"code-72\" class=\"wp-block-code\"><code class=\"\">func TestDeleteArticle(t *testing.T) {\n    t.Run(\"DELETE article - 404\", func(t *testing.T) {\n        w := setRouter(\"DELETE\", baseUrl+\"\/42\", nil)\n\n        assert.Equal(t, 404, w.Code)\n        assert.Equal(t, messageNotFound, w.Body.String())\n    })\n\n    t.Run(\"DELETE article - 200\", func(t *testing.T) {\n        w := setRouter(\"DELETE\", baseUrl+\"\/1\", nil)\n\n        assert.Equal(t, 200, w.Code)\n        assert.Equal(t, `{\"success\":\"Article #1 deleted\"}`, w.Body.String())\n    })\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Premier test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type DELETE sur l\u2019url <code>\/api\/v1\/articles\/42<\/code> ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 400 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir le message d\u2019erreur g\u00e9n\u00e9rique d\u00e9di\u00e9.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Second test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type DELETE sur l\u2019url <code>\/api\/v1\/articles\/1<\/code> ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 200 ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir le message de succ\u00e8s attendu.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#ex%C3%A9cution-des-tests\"><\/a>Ex\u00e9cution des tests<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Pour ex\u00e9cuter les tests hors de votre IDE c\u2019est avec la commande <code>go test .\/controllers<\/code> (ou <code>go test .\/controllers -v<\/code> pour le mode verbeux).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#taux-de-couverture\"><\/a>Taux de couverture<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Pour avoir le taux de couverture, il faut ajouter un param\u00e8tre \u00e0 la commande.<\/p>\n\n\n\n<pre id=\"code-73\" class=\"wp-block-code\"><code class=\"\">$ go test .\/controllers -coverprofile=cover.cov\nok      demo-api-gin\/api        0.038s  coverage: 98.1% of statements<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Ou en global avec \u201cgo tool\u201d.<\/p>\n\n\n\n<pre id=\"code-74\" class=\"wp-block-code\"><code class=\"\">go tool cover -func profile.cov\n        demo-api-gin\/api                coverage: 0.0% of statements\n        demo-api-gin            coverage: 0.0% of statements\n        demo-api-gin\/db         coverage: 0.0% of statements\n        demo-api-gin\/models             coverage: 0.0% of statements\n        demo-api-gin\/routes             coverage: 0.0% of statements\nok      demo-api-gin\/controllers        0.039s  coverage: 80.9% of statements<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Remarque: si vous utilisez Sonarqube, c\u2019est ce fichier qu\u2019il faut renseigner comme \u00e9tant le fichier de coverage <code>sonar.go.coverage.reportPaths=cover.cov<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Le fichier <code>cover.cov<\/code> est lisible en langage \u201chumain\u201d en g\u00e9n\u00e9rant le rapport en HTML avec la commande <code>go tool cover -html=cover.cov -o cover.html<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Bonus : CORS<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Si vous souhaitez communiquer avec l\u2019API (hors requ\u00eates GET) depuis le navigateur Internet, vous aurez ce genre d\u2019erreur dans votre navigateur web<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">Blocage d\u2019une requ\u00eate multiorigines (Cross-Origin Request) : la politique \u00ab Same Origin \u00bb ne permet pas de consulter la ressource distante. Raison : l\u2019en-t\u00eate CORS \u00ab Access-Control-Allow-Origin \u00bb est manquant. Code d\u2019\u00e9tat : 201.<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\">Pour parer \u00e0 ce genre d\u2019erreur, il faut modifier les en-t\u00eates des requ\u00eates HTTP.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#cr%C3%A9ation-du-midlleware\"><\/a>Cr\u00e9ation du midlleware<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">A la racine du projet, cr\u00e9ez un dossier <code>middlewares<\/code> avec un fichier <code>cors.go<\/code>.<\/p>\n\n\n\n<pre id=\"code-75\" class=\"wp-block-code\"><code class=\"\">\/\/ middlewares\/cors\n\npackage middlewares\n\nimport (\n    \"github.com\/gin-gonic\/gin\"\n)\n\n\/\/ Activation du CORS\nfunc Cors() gin.HandlerFunc {\n    return func(c *gin.Context) {\n        c.Writer.Header().Set(\"Access-Control-Allow-Origin\", \"*\")\n        c.Writer.Header().Set(\"Access-Control-Allow-Credentials\", \"true\")\n        c.Writer.Header().Set(\"Access-Control-Allow-Headers\", \"Content-Type, Content-Length, Accept-Encoding, accept, origin, Cache-Control, X-Requested-With\")\n        c.Writer.Header().Set(\"Access-Control-Allow-Methods\", \"POST, PUT, DELETE, OPTIONS\")\n\n        if c.Request.Method == \"OPTIONS\" {\n            c.AbortWithStatus(204)\n            return\n        }\n\n        c.Next()\n    }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Cette fonction est appel\u00e9e comme middleware dans Gin dans la fonction <code>Handlers<\/code> du fichier <code>api.go<\/code>.<\/p>\n\n\n\n<pre id=\"code-76\" class=\"wp-block-code\"><code class=\"\">func Handlers() *gin.Engine {\n    \/\/ Code inchang\u00e9\n    r := gin.Default()\n    r.Use(middlewares.Cors())\n    \/\/ Code inchang\u00e9\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#tester-le-middleware\"><\/a>Tester le middleware<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Sans oublier les tests dans le fichier <code>cors_test.go<\/code>.<\/p>\n\n\n\n<pre id=\"code-77\" class=\"wp-block-code\"><code class=\"\">package middlewares_test\n\nimport (\n    \"demo-api-gin\/api\"\n    \"net\/http\"\n    \"net\/http\/httptest\"\n    \"testing\"\n\n    \"github.com\/stretchr\/testify\/assert\"\n)\n\nfunc TestCors(t *testing.T) {\n    t.Run(\"TestCors Headers\", func(t *testing.T) {\n        router := api.Handlers()\n        w := httptest.NewRecorder()\n        req, _ := http.NewRequest(\"GET\", \"\/api\/v1\/articles\", nil)\n        router.ServeHTTP(w, req)\n\n        assert.Equal(t, w.Header().Get(\"Access-Control-Allow-Origin\"), \"*\")\n        assert.Equal(t, w.Header().Get(\"Access-Control-Allow-Credentials\"), \"true\")\n        assert.Equal(t, w.Header().Get(\"Access-Control-Allow-Headers\"), \"Content-Type, Content-Length, Accept-Encoding, accept, origin, Cache-Control, X-Requested-With\")\n        assert.Equal(t, w.Header().Get(\"Access-Control-Allow-Methods\"), \"POST, PUT, DELETE, OPTIONS\")\n    })\n\n    t.Run(\"TestCors Options\", func(t *testing.T) {\n        router := api.Handlers()\n        w := httptest.NewRecorder()\n        req, _ := http.NewRequest(\"OPTIONS\", \"\/api\/v1\/articles\", nil)\n        router.ServeHTTP(w, req)\n\n        assert.Equal(t, 204, w.Code)\n    })\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Premier test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type GET sur l\u2019url <code>\/api\/v1\/articles<\/code> ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir les 4 en-t\u00e8tes li\u00e9s au CORS.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Second test :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On fait un appel de type OPTIONS sur l\u2019url <code>\/api\/v1\/articles\/1<\/code> ;<\/li>\n\n\n\n<li>On s\u2019attend \u00e0 recevoir un code HTTP avec la valeur 204.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Ainsi, on peut utiliser la fonction native de JavaScript <code>fetch<\/code> avec l\u2019exemple ci-dessous.<\/p>\n\n\n\n<pre id=\"code-78\" class=\"wp-block-code\"><code class=\"\">async function addArticle(title, description) {\n    if (title &amp;&amp; description) {\n        const body = JSON.stringify({ title, description });\n        const response = await fetch(url, {\n            method: \"POST\",\n            body,\n        });\n        const post = await response.json();\n        console.log(post)\n    }\n}\n\naddArticle(\"ici le titre\", \"ici la description\");<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#ressources\"><\/a>Ressources<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/github.com\/gin-gonic\/gin\" target=\"_blank\">Gin<\/a> ;<\/li>\n\n\n\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/github.com\/go-gorm\/gorm\" target=\"_blank\">Gorm<\/a> ;<\/li>\n\n\n\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/github.com\/go-gorm\/sqlite\" target=\"_blank\">Gorm SQLite<\/a> ;<\/li>\n\n\n\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/github.com\/cosmtrek\/air\" target=\"_blank\">Air<\/a> ;<\/li>\n\n\n\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/github.com\/go-playground\/validator\" target=\"_blank\">Go Validator<\/a> ;<\/li>\n\n\n\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/github.com\/stretchr\/testify\" target=\"_blank\">Testify<\/a>.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Article \u00e9crit par Etienne R. Pour cr\u00e9er une API Rest en Go, il existe de nombreux frameworks dit \u201chttp\u201d d\u00e9di\u00e9s. C\u2019est un framework qui g\u00e8re les<span class=\"excerpt-hellip\"> [\u2026]<\/span><\/p>\n","protected":false},"author":10,"featured_media":15700,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","inline_featured_image":false,"fifu_image_url":"","fifu_image_alt":"","footnotes":""},"categories":[34],"tags":[],"class_list":["post-15270","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-articles-techniques"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.9 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Cr\u00e9er une API REST en Go - Ouidou<\/title>\n<meta name=\"description\" content=\"Dans cette article vous apprendrez comment cr\u00e9er une API REST en Go. Notre expert vous guidera dans l\u2019utilisation de framework Gin.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go\" \/>\n<meta property=\"og:locale\" content=\"fr_FR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Cr\u00e9er une API REST en Go - Ouidou\" \/>\n<meta property=\"og:description\" content=\"Dans cette article vous apprendrez comment cr\u00e9er une API REST en Go. Notre expert vous guidera dans l\u2019utilisation de framework Gin.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go\" \/>\n<meta property=\"og:site_name\" content=\"Ouidou\" \/>\n<meta property=\"article:published_time\" content=\"2024-07-09T07:45:48+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2024-09-03T13:29:20+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/05\/Configuration-du-Web-Terminal-de-Gitlab-2.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1105\" \/>\n\t<meta property=\"og:image:height\" content=\"564\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Sara Lourties\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u00c9crit par\" \/>\n\t<meta name=\"twitter:data1\" content=\"Sara Lourties\" \/>\n\t<meta name=\"twitter:label2\" content=\"Dur\u00e9e de lecture estim\u00e9e\" \/>\n\t<meta name=\"twitter:data2\" content=\"9 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go\"},\"author\":{\"name\":\"Sara Lourties\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#\\\/schema\\\/person\\\/e1d66085fb7c22ede319ce56adc373a4\"},\"headline\":\"Cr\u00e9er une API REST en Go\",\"datePublished\":\"2024-07-09T07:45:48+00:00\",\"dateModified\":\"2024-09-03T13:29:20+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go\"},\"wordCount\":1850,\"publisher\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2024\\\/05\\\/Configuration-du-Web-Terminal-de-Gitlab-2.png\",\"articleSection\":[\"Articles Techniques\"],\"inLanguage\":\"fr-FR\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go\",\"url\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go\",\"name\":\"Cr\u00e9er une API REST en Go - Ouidou\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2024\\\/05\\\/Configuration-du-Web-Terminal-de-Gitlab-2.png\",\"datePublished\":\"2024-07-09T07:45:48+00:00\",\"dateModified\":\"2024-09-03T13:29:20+00:00\",\"description\":\"Dans cette article vous apprendrez comment cr\u00e9er une API REST en Go. Notre expert vous guidera dans l\u2019utilisation de framework Gin.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go#breadcrumb\"},\"inLanguage\":\"fr-FR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go#primaryimage\",\"url\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2024\\\/05\\\/Configuration-du-Web-Terminal-de-Gitlab-2.png\",\"contentUrl\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2024\\\/05\\\/Configuration-du-Web-Terminal-de-Gitlab-2.png\",\"width\":1105,\"height\":564},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/creer-une-api-rest-en-go#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Cr\u00e9er une API REST en Go\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/\",\"name\":\"Blog Ouidou\",\"description\":\"Conseil et expertise en technologies\",\"publisher\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"fr-FR\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#organization\",\"name\":\"Ouidou\",\"url\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2022\\\/04\\\/image_2022-04-13_150237378.png\",\"contentUrl\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2022\\\/04\\\/image_2022-04-13_150237378.png\",\"width\":180,\"height\":180,\"caption\":\"Ouidou\"},\"image\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#\\\/schema\\\/person\\\/e1d66085fb7c22ede319ce56adc373a4\",\"name\":\"Sara Lourties\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g\",\"caption\":\"Sara Lourties\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Cr\u00e9er une API REST en Go - Ouidou","description":"Dans cette article vous apprendrez comment cr\u00e9er une API REST en Go. Notre expert vous guidera dans l\u2019utilisation de framework Gin.","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:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go","og_locale":"fr_FR","og_type":"article","og_title":"Cr\u00e9er une API REST en Go - Ouidou","og_description":"Dans cette article vous apprendrez comment cr\u00e9er une API REST en Go. Notre expert vous guidera dans l\u2019utilisation de framework Gin.","og_url":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go","og_site_name":"Ouidou","article_published_time":"2024-07-09T07:45:48+00:00","article_modified_time":"2024-09-03T13:29:20+00:00","og_image":[{"width":1105,"height":564,"url":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/05\/Configuration-du-Web-Terminal-de-Gitlab-2.png","type":"image\/png"}],"author":"Sara Lourties","twitter_card":"summary_large_image","twitter_misc":{"\u00c9crit par":"Sara Lourties","Dur\u00e9e de lecture estim\u00e9e":"9 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go#article","isPartOf":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go"},"author":{"name":"Sara Lourties","@id":"https:\/\/ouidou.fr\/blog\/#\/schema\/person\/e1d66085fb7c22ede319ce56adc373a4"},"headline":"Cr\u00e9er une API REST en Go","datePublished":"2024-07-09T07:45:48+00:00","dateModified":"2024-09-03T13:29:20+00:00","mainEntityOfPage":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go"},"wordCount":1850,"publisher":{"@id":"https:\/\/ouidou.fr\/blog\/#organization"},"image":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go#primaryimage"},"thumbnailUrl":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/05\/Configuration-du-Web-Terminal-de-Gitlab-2.png","articleSection":["Articles Techniques"],"inLanguage":"fr-FR"},{"@type":"WebPage","@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go","url":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go","name":"Cr\u00e9er une API REST en Go - Ouidou","isPartOf":{"@id":"https:\/\/ouidou.fr\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go#primaryimage"},"image":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go#primaryimage"},"thumbnailUrl":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/05\/Configuration-du-Web-Terminal-de-Gitlab-2.png","datePublished":"2024-07-09T07:45:48+00:00","dateModified":"2024-09-03T13:29:20+00:00","description":"Dans cette article vous apprendrez comment cr\u00e9er une API REST en Go. Notre expert vous guidera dans l\u2019utilisation de framework Gin.","breadcrumb":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go#breadcrumb"},"inLanguage":"fr-FR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go"]}]},{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go#primaryimage","url":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/05\/Configuration-du-Web-Terminal-de-Gitlab-2.png","contentUrl":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/05\/Configuration-du-Web-Terminal-de-Gitlab-2.png","width":1105,"height":564},{"@type":"BreadcrumbList","@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/creer-une-api-rest-en-go#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/ouidou.fr\/blog\/"},{"@type":"ListItem","position":2,"name":"Cr\u00e9er une API REST en Go"}]},{"@type":"WebSite","@id":"https:\/\/ouidou.fr\/blog\/#website","url":"https:\/\/ouidou.fr\/blog\/","name":"Blog Ouidou","description":"Conseil et expertise en technologies","publisher":{"@id":"https:\/\/ouidou.fr\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ouidou.fr\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"fr-FR"},{"@type":"Organization","@id":"https:\/\/ouidou.fr\/blog\/#organization","name":"Ouidou","url":"https:\/\/ouidou.fr\/blog\/","logo":{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/ouidou.fr\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2022\/04\/image_2022-04-13_150237378.png","contentUrl":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2022\/04\/image_2022-04-13_150237378.png","width":180,"height":180,"caption":"Ouidou"},"image":{"@id":"https:\/\/ouidou.fr\/blog\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/ouidou.fr\/blog\/#\/schema\/person\/e1d66085fb7c22ede319ce56adc373a4","name":"Sara Lourties","image":{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/secure.gravatar.com\/avatar\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g","caption":"Sara Lourties"}}]}},"_links":{"self":[{"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/posts\/15270","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/comments?post=15270"}],"version-history":[{"count":5,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/posts\/15270\/revisions"}],"predecessor-version":[{"id":16037,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/posts\/15270\/revisions\/16037"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/media\/15700"}],"wp:attachment":[{"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/media?parent=15270"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/categories?post=15270"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/tags?post=15270"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}