api

Documentation

Index

• Constants
• type API
  • func New(_ context.Context, cfg *config.Config, r chi.Router, idc *identity.Client, ...) *API
  • func (api *API) ParseRequest(body io.Reader, req interface{}) error
• type DatasetJSONDimension
• type DatasetJSONLinks
• type Error
  • func (e Error) BadRequest() bool
  • func (e Error) Error() string
  • func (e Error) LogData() map[string]interface{}
  • func (e Error) Message() string
  • func (e Error) NotFound() bool
  • func (e Error) Unwrap() error
• type GetDatasetJSONResponse
• type GetFilterDimensionOptionsItem
• type GetFilterDimensionOptionsResponse

Constants

const (
	DefaultLimit  = 20
	DefaultOffset = 0
)

Types

type API

type API struct {
	Router chi.Router
	// contains filtered or unexported fields
}

API provides a struct to wrap the api around

func New

func New(_ context.Context, cfg *config.Config, r chi.Router, idc *identity.Client, rsp responder, g generator, d datastore, ds datasetAPIClient, c cantabularClient, p kafka.IProducer) *API

New creates and initialises a new API

func (*API) ParseRequest

func (api *API) ParseRequest(body io.Reader, req interface{}) error

NOTE: for multivariate tables, it is going to use the name field for the id when making the call to cantabular.

type DatasetJSONDimension

type DatasetJSONDimension struct {
	DimensionName string       `json:"dimension_name"`
	Options       []model.Link `json:"options"`
}

type DatasetJSONLinks

type DatasetJSONLinks struct {
	DatasetMetadata model.Link `json:"dataset_metadata"`
	Self            model.Link `json:"self"`
	Version         model.Link `json:"version"`
}

type Error

type Error struct {
	// contains filtered or unexported fields
}

Error is the packages error type

func (Error) BadRequest

func (e Error) BadRequest() bool

BadRequest satisfies the errBadRequest interface

func (Error) Error

func (e Error) Error() string

Error satisfies the standard library Go error interface

func (Error) LogData

func (e Error) LogData() map[string]interface{}

LogData satisfies the dataLogger interface which is used to recover log data from an error

func (Error) Message

func (e Error) Message() string

Message satisfies the messager interface which is used to specify a response to be sent to the caller in place of the error text for a given error. This is useful when you don't want sensitive information or implementation details being exposed to the caller which could be used to find exploits in our API

func (Error) NotFound

func (e Error) NotFound() bool

NotFound satisfies the errNotFound interface

func (Error) Unwrap

func (e Error) Unwrap() error

Unwrap implements the standard library Go unwrapper interface

type GetDatasetJSONResponse

type GetDatasetJSONResponse struct {
	Dimensions        []DatasetJSONDimension `json:"dimensions"`
	Links             DatasetJSONLinks       `json:"links"`
	Observations      []int                  `json:"observations"`
	TotalObservations int                    `json:"total_observations"`
}

getDatasetJSONResponse is the response body for GET /datasets/{dataset_id}/editions/{edition}/versions/{version}/json

type GetFilterDimensionOptionsItem

type GetFilterDimensionOptionsItem struct {
	Option    string     `json:"option"`
	Self      model.Link `json:"self"`
	Filter    model.Link `json:"filter"`
	Dimension model.Link `json:"Dimension"`
}

type GetFilterDimensionOptionsResponse

type GetFilterDimensionOptionsResponse struct {
	Items []GetFilterDimensionOptionsItem `json:"items"`
	// contains filtered or unexported fields
}

getDimensionOptionsResponse is the response body for GET /filters/{id}/dimensions/{name}/options