How to pass Authentication Header Token when POSTing data to an API using Golang

This guide explains how to pass an Authentication Header Token when making a POST request to an API using Golang. It covers handling HTTP requests, adding a token to the Header for authentication, and sending data to an API.

In this article, we'll show how to make a POST request to an API in Golang and pass a Token in the Authentication Header for authentication. Using http.NewRequest and http.Client, we can send data along with attaching the token in the request.

Golang Code:

package main

import (
    "bytes"
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    url := "https://example.com/api"
    token := "Bearer your_token_here"
    
    // Create JSON data to send
    jsonData := []byte(`{"key": "value"}`)
    
    // Create a POST request
    req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    if err != nil {
        fmt.Println("Error creating request:", err)
        return
    }
    
    // Set Content-Type to JSON and add Token to the Header
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", token)
    
    // Use http.Client to send the request
    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error making POST request:", err)
        return
    }
    defer resp.Body.Close()

    // Read the response from the API
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("Error reading response:", err)
        return
    }
    
    // Print the response to the console
    fmt.Println("Response Body:", string(body))
}

Detailed explanation:

1. url := "https://example.com/api": The API endpoint you want to send data to.
2. token := "Bearer your_token_here": The token string for API authentication, usually in the form "Bearer {token}".
3. jsonData := []byte({"key": "value"}): Create JSON data to send in the POST request.
4. req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData)): Create an HTTP POST request with the JSON data.
5. req.Header.Set("Content-Type", "application/json"): Set the Content-Type for the request as JSON.
6. req.Header.Set("Authorization", token): Add the Authentication Header Token to the request.
7. client := &http.Client{}: Create an HTTP client to send the request.
8. resp, err := client.Do(req): Send the POST request to the API.
9. body, err := ioutil.ReadAll(resp.Body): Read the response from the API.

System requirements:

• Go version 1.16 or higher
• Internet connection to call the API

How to install the libraries needed to run the above Golang code:

• No external libraries required, net/http and io/ioutil are part of Golang's standard library.

Tips:

• Ensure your token is valid and regularly updated when working with secure API services.
• Consider using the context package to handle timeouts for your HTTP requests to avoid hanging requests.

---