History

Jeff Mitchell 9cddc187b5 Don't use http.DefaultClient Two of the changes are in tests; the one of consequence is in the API. As explained in #1308 this can cause conflicts with downstream programs. Fixes #1308.		2015-10-15 17:49:35 -04:00
..
acl.go
acl_test.go
agent.go
agent_test.go
api.go	Don't use http.DefaultClient	2015-10-15 17:49:35 -04:00
api_test.go
catalog.go
catalog_test.go
event.go
event_test.go
health.go	remove various typos	2015-09-11 12:29:54 -07:00
health_test.go
kv.go	Fix a bunch of typos.	2015-09-15 13:22:08 +01:00
kv_test.go
lock.go
lock_test.go	Fix a bunch of typos.	2015-09-15 13:22:08 +01:00
raw.go
README.md
semaphore.go	Fix a bunch of typos.	2015-09-15 13:22:08 +01:00
semaphore_test.go
session.go	Merge pull request #1041 from rboyer/api-fix-session-renew	2015-09-25 13:15:54 -07:00
session_test.go	Correct the Session.Renew{,Periodic} to handle session expiration better	2015-09-14 08:52:32 -05:00
status.go
status_test.go

README.md

Consul API client

This package provides the api package which attempts to provide programmatic access to the full Consul API.

Currently, all of the Consul APIs included in version 0.3 are supported.

Documentation

The full documentation is available on Godoc

Usage

Below is an example of using the Consul client:

// Get a new client, with KV endpoints
client, _ := api.NewClient(api.DefaultConfig())
kv := client.KV()

// PUT a new KV pair
p := &api.KVPair{Key: "foo", Value: []byte("test")}
_, err := kv.Put(p, nil)
if err != nil {
    panic(err)
}

// Lookup the pair
pair, _, err := kv.Get("foo", nil)
if err != nil {
    panic(err)
}
fmt.Printf("KV: %v", pair)