feat: Add the post with headers util function for HTTP clients

clients/http/utils/common.go

@@ -146,6 +146,20 @@ func createRequestWithRawData(ctx context.Context, httpMethod string, baseUrl st
 	return req, nil
 }
 
+func createRequestWithRawDataAndHeaders(ctx context.Context, httpMethod string, baseUrl string, requestPath string, requestParams url.Values, data any, headers map[string]string) (*http.Request, errors.EdgeX) {
+	req, err := createRequestWithRawData(ctx, httpMethod, baseUrl, requestPath, requestParams, data)
+	if err != nil {
+		return nil, errors.NewCommonEdgeXWrapper(err)
+	}
+
+	// Add the additional headers from request
+	for name, value := range headers {
+		req.Header.Set(name, value)
+	}
+
+	return req, nil
+}
+
 func createRequestWithEncodedData(ctx context.Context, httpMethod string, baseUrl string, requestPath string, data []byte, encoding string) (*http.Request, errors.EdgeX) {
 	u, err := parseBaseUrlAndRequestPath(baseUrl, requestPath)
 	if err != nil {

clients/http/utils/request.go

@@ -100,6 +100,23 @@ func PostRequestWithRawData(
 	return processRequest(ctx, returnValuePointer, req, authInjector)
 }
 
+// PostRequestWithRawDataAndHeaders makes the post JSON request with raw data and request headers, and returns the body
+func PostRequestWithRawDataAndHeaders(
+	ctx context.Context,
+	returnValuePointer interface{},
+	baseUrl string, requestPath string,
+	requestParams url.Values,
+	data interface{}, authInjector interfaces.AuthenticationInjector,
+	headers map[string]string) errors.EdgeX {
+
+	req, err := createRequestWithRawDataAndHeaders(ctx, http.MethodPost, baseUrl, requestPath, requestParams, data, headers)
+	if err != nil {
+		return errors.NewCommonEdgeXWrapper(err)
+	}
+
+	return processRequest(ctx, returnValuePointer, req, authInjector)
+}
+
 // PutRequest makes the put JSON request and return the body
 func PutRequest(
 	ctx context.Context,

errors/types.go

@@ -36,6 +36,7 @@ const (
 	KindOverflowError       ErrKind = "OverflowError"
 	KindNaNError            ErrKind = "NaNError"
 	KindUnauthorized        ErrKind = "Unauthorized"
+	KindForbidden           ErrKind = "Forbidden"
 )
 
 // EdgeX provides an abstraction for all internal EdgeX errors.
@@ -209,7 +210,7 @@ func codeMapping(kind ErrKind) int {
 		return http.StatusMethodNotAllowed
 	case KindRangeNotSatisfiable:
 		return http.StatusRequestedRangeNotSatisfiable
-	case KindIOError:
+	case KindIOError, KindForbidden:
 		return http.StatusForbidden
 	case KindUnauthorized:
 		return http.StatusUnauthorized
@@ -245,6 +246,8 @@ func KindMapping(code int) ErrKind {
 		return KindRangeNotSatisfiable
 	case http.StatusUnauthorized:
 		return KindUnauthorized
+	case http.StatusForbidden:
+		return KindForbidden
 	default:
 		return KindUnknown
 	}