THIS DOCUMENTATION HAS MOVED TO ory.sh/docs/hydra

Go SDK

Installation

To install the Go SDK, run:

go get -u -d github.com/ory/hydra/sdk/go/hydra

Configuration

The Go SDK is auto generated from swagger but contains some helpers, such as NewSDK:

import "github.com/ory/hydra/sdk/go/hydra"

sdk, err := hydra.NewSDK(&hydra.Configuration{
    ClientID:     "foo",
    ClientSecret: "bar",
    EndpointURL:  "https://hydra.localhost:4444",
    Scopes:       []string{"hydra.*"},
})

API Usage

APIs usually have three return values. Please check for errors as well as status codes!

policy, response, error := sdk.CreatePolicy(swagger.Policy{ /* .... payload .... */})
if err != nil {
    // This usually indicates a network error.
} else if response.StatusCode != http.StatusCreated {
    // If the status code is not 2xx, something went wrong on the application level (e.g. wrong credentials, database offline, ...)
}

fmt.Printf("Policy created: %+v", policy)

In rare cases, methods have only two return values. This happens when the REST API returns 204 No Content:

response, err := sdk.DeletePolicy("policy-id")
if err != nil {
    // This usually indicates a network error.
} else if response.StatusCode != http.StatusNoContent {
    // If the status code is not 2xx, something went wrong on the application level (e.g. wrong credentials, database offline, ...)
}

API Docs

API docs are available here.
Please note that those docs are generated and may introduce bugs if code examples are used 1:1.