History

James Phillips 181c216f53 Fixes index management for KVS.		9 years ago
..
README.md	api: initial import from armon/consul-api	10 years ago
acl.go	Revert "fixed: body not closed for non HTTP 200 responses"	10 years ago
acl_test.go	api: run ACL tests by default	10 years ago
agent.go	Add TCP check type	9 years ago
agent_test.go	Fix tests after merge	10 years ago
api.go	Don't use http.DefaultClient	9 years ago
api_test.go	api: run ACL tests by default	10 years ago
catalog.go	Add 'ServiceAddress' field to 'CatalogService's truct	10 years ago
catalog_test.go	api: run tests in parallel	10 years ago
event.go	Revert "fixed: body not closed for non HTTP 200 responses"	10 years ago
event_test.go	api: improve test reliability	10 years ago
health.go	remove various typos	9 years ago
health_test.go	api: run tests in parallel	10 years ago
kv.go	Fix a bunch of typos.	9 years ago
kv_test.go	Fixes a broken unit test introduced by #834 .	10 years ago
lock.go	Check to see why a lock acquisition failed	10 years ago
lock_test.go	Fixes index management for KVS.	9 years ago
raw.go	api: Refactoring into shared write logic	10 years ago
semaphore.go	Fix a bunch of typos.	9 years ago
semaphore_test.go	api: run tests in parallel	10 years ago
session.go	Merge pull request #1041 from rboyer/api-fix-session-renew	9 years ago
session_test.go	Correct the Session.Renew{,Periodic} to handle session expiration better	9 years ago
status.go	Revert "fixed: body not closed for non HTTP 200 responses"	10 years ago
status_test.go	api: run tests in parallel	10 years ago

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)