HTTP Client

Gosip HTTP client for SharePoint allows consuming any HTTP resource or API, it can even bypass SharePoint site pages (with all assets) within a dev toolchain (proxy, dev server).
Gosip HTTP client is SharePoint nuances-aware, it takes care under the hood of such things as headers, API calls retries, threshholds, error handling, POST API requests Digests, and, of course, authentication and its renewal.
However, dealing at low-level, means you should know SharePoint API rather well and you're ok with the verbosity of Go. If you just starting with SharePoint please consider Fluent API client first and HTTP client for none covered methods and custom stuff.
Usage
1
package main
2
​
3
import (
4
	"fmt"
5
	"log"
6
​
7
	"github.com/koltyakov/gosip"
8
	"github.com/koltyakov/gosip/api"
9
	strategy "github.com/koltyakov/gosip/auth/ntlm"
10
)
11
​
12
func main() {
13
	auth := &strategy.AuthCnfg{}
14
	configPath := "./config/private.json"
15
	if err := auth.ReadConfig(configPath); err != nil {
16
		log.Fatalf("unable to get config: %v\n", err)
17
	}
18
​
19
	spClient := api.NewHTTPClient(&gosip.SPClient{AuthCnfg: auth})
20
​
21
	endpoint := auth.GetSiteURL() + "/_api/web?$select=Title"
22
​
23
	data, err := spClient.Get(endpoint, nil)
24
	if err != nil {
25
			log.Fatalf("%v\n", err)
26
	}
27
​
28
	// spClient.Post(endpoint, body, nil) // generic POST
29
​
30
	// generic DELETE helper crafts "X-Http-Method"="DELETE" header
31
	// spClient.Delete(endpoint, nil)
32
​
33
	// generic UPDATE helper crafts "X-Http-Method"="MERGE" header
34
	// spClient.Update(endpoint, body, nil)
35
​
36
	// CSOM helper (client.svc/ProcessQuery)
37
	// spClient.ProcessQuery(endpoint, body, nil)
38
​
39
	fmt.Printf("response: %s\n", data)
40
}
Copied!
Methods
HTTP Client methods covers those which used in SharePoint all the way.
In a contract to default Go http.Client's .Do method, Gosip HTTP Client's methods proceed and read response body to return array of bytes. Which reduce amount of scaffolded code a bit and more handy for the REST API consumption, in our opinion, which is 90% of use cases.
Get
Sends GET request, embeds "Accept": "application/json;odata=verbose" header as a default. Use it for REST API GET calls.
Post
Sends POST request, embeds "Accept": "application/json;odata=verbose" and "Content-Type": "application/json;odata=verbose;charset=utf-8" headers as default. X-RequestDigest is received, cached, and embed automattically. Use it for REST API POST calls.
Delete
Sends POST request, embeds "Accept": "application/json;odata=verbose", "Content-Type": "application/json;odata=verbose;charset=utf-8", and "X-Http-Method": "DELETE" headers as default. X-RequestDigest is received, cached, and embed automattically. Use it for REST API POST calls with delete resource intention.
Update
Sends POST request, embeds "Accept": "application/json;odata=verbose", "Content-Type": "application/json;odata=verbose;charset=utf-8", and "X-Http-Method": "MERGE" headers as default. X-RequestDigest is received, cached, and embed automattically. Use it for REST API POST calls with update resource intention.
ProcessQuery
Sends POST request to /_vti_bin/client.svc/ProcessQuery endpoint (CSOM). All required headers for a CSOM request are embed automatically. Method's body should stand for a valid CSOM XML package. The response body is parsed for error handling, yet returned in it's original form.
Low-level HTTP client
Sometimes more control is required, e.g. when downloading files or large responses you could prefer precessing a response in chunks. This can be achieved with the low-level usage of Gosip HTTP client.
1
client := &gosip.SPClient{AuthCnfg: auth}
2
​
3
var req *http.Request
4
// Initiate API request
5
// ...
6
​
7
resp, err := client.Execute(req)
8
if err != nil {
9
  fmt.Printf("Unable to request api: %v", err)
10
  return
11
}
Copied!
SPClient has Execute method which is a wrapper function injecting SharePoint authentication and ending up calling http.Client's Do method.
So you can dive down to native *http.Request at this point it's just a standard request from "net/http" package, but authenticated to SharePoint and with some batteries under the hood for a seemles API integration.

Dynamic auth

Next - SharePoint client

Fluent API

Last modified 2yr ago

Export as PDF

Copy link

Contents

Usage

Methods

ProcessQuery

Low-level HTTP client