Liking cljdoc? Tell your friends :D

API

Version: 0.2.1

/v1beta1/namespaces

GET

Summary

List names of namespaces

Responses

Code	Description	Schema
200	A successful response.	v1beta1ListNamespacesResponse
default	An unexpected error response.	rpcStatus

POST

Summary

Create namespace entry

Parameters

Name	Located in	Description	Required	Schema
body	body		Yes	v1beta1CreateNamespaceRequest

Responses

Code	Description	Schema
200	A successful response.	v1beta1CreateNamespaceResponse
default	An unexpected error response.	rpcStatus

/v1beta1/namespaces/{id}

GET

Summary

Get namespace by id

Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	v1beta1GetNamespaceResponse
default	An unexpected error response.	rpcStatus

DELETE

Summary

Delete namespace by id

Description

Ensure all schemas under this namespace is deleted, otherwise it will throw error

Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	v1beta1DeleteNamespaceResponse
default	An unexpected error response.	rpcStatus

PUT

Summary

Update namespace entity by id

Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	string
body	body		Yes	object

Responses

Code	Description	Schema
200	A successful response.	v1beta1UpdateNamespaceResponse
default	An unexpected error response.	rpcStatus

/v1beta1/namespaces/{id}/schemas

GET

Summary

List schemas under the namespace

Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	v1beta1ListSchemasResponse
default	An unexpected error response.	rpcStatus

/v1beta1/namespaces/{namespaceId}/schemas/{schemaId}

GET

Summary

Get latest schema

Description

Returns latest schema in it's own data type. For protobuf response type would be 'application/octet-stream'. Avro, json schema response type would be 'application/json'

Parameters

Name	Located in	Description	Required	Schema
namespaceId	path		Yes	string
schemaId	path		Yes	string

Responses

Code	Description	Schema
200	A successful schema response. Based on schema format, response will return different content types. For avro and json schemas response type is `application/json`. For protobuf response type is `application/octet-stream`.
default	An unexpected error response.	rpcStatus

POST

Summary

Create schema under the namespace

Parameters

Name	Located in	Description	Required	Schema
namespaceId	path		Yes	string
schemaId	path		Yes	string
body	body	Request payload should be equivalent to `curl` `--data-binary` option	Yes	binary

Responses

Code	Description	Schema
200	A successful response.	v1beta1CreateSchemaResponse
default	An unexpected error response.	rpcStatus

DELETE

Summary

Delete specified schema

Parameters

Name	Located in	Description	Required	Schema
namespaceId	path		Yes	string
schemaId	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	v1beta1DeleteSchemaResponse
default	An unexpected error response.	rpcStatus

PATCH

Summary

Update only schema metadata

Parameters

Name	Located in	Required	Schema
namespaceId	path	Yes	string
schemaId	path	Yes	string
body	body	Yes	object

Responses

Code	Description	Schema
200	A successful response.	v1beta1UpdateSchemaMetadataResponse
default	An unexpected error response.	rpcStatus

/v1beta1/namespaces/{namespaceId}/schemas/{schemaId}/check

POST

Summary

Check schema compatibility

Description

Checks comptibility with existing latest schema

Parameters

Name	Located in	Required	Schema
namespaceId	path	Yes	string
schemaId	path	Yes	string
body	body	Yes	binary
X-Compatibility	header	No	string

Responses

Code	Description	Schema
200	A successful response.	v1beta1CreateSchemaResponse
default	An unexpected error response.	rpcStatus

/v1beta1/namespaces/{namespaceId}/schemas/{schemaId}/meta

GET

Summary

Create schema under the namespace. Returns version number, unique ID and location

Parameters

Name	Located in	Description	Required	Schema
namespaceId	path		Yes	string
schemaId	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	v1beta1GetSchemaMetadataResponse
default	An unexpected error response.	rpcStatus

/v1beta1/namespaces/{namespaceId}/schemas/{schemaId}/versions

GET

Summary

List all version numbers for schema

Parameters

Name	Located in	Description	Required	Schema
namespaceId	path		Yes	string
schemaId	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	v1beta1ListVersionsResponse
default	An unexpected error response.	rpcStatus

/v1beta1/namespaces/{namespaceId}/schemas/{schemaId}/versions/{versionId}

DELETE

Summary

Delete specified version of the schema

Parameters

Name	Located in	Required	Schema
namespaceId	path	Yes	string
schemaId	path	Yes	string
versionId	path	Yes	integer

Responses

Code	Description	Schema
200	A successful response.	v1beta1DeleteVersionResponse
default	An unexpected error response.	rpcStatus

/v1beta1/search

GET

Summary

Global Search API

Parameters

Name	Located in	Required	Schema
namespaceId	query	No	string
schemaId	query	No	string
query	query	Yes	string
history	query	No	boolean
versionId	query	No	integer

Responses

Code	Description	Schema
200	A successful response.	v1beta1SearchResponse
default	An unexpected error response.	rpcStatus

Models

SchemaCompatibility

Name	Type	Description	Required
SchemaCompatibility	string

SchemaFormat

Name	Type	Description	Required
SchemaFormat	string

protobufAny

Name	Type	Description	Required
typeUrl	string		No
value	byte		No

rpcStatus

Name	Type	Required
code	integer	No
message	string	No
details	[ protobufAny ]	No

v1beta1CheckCompatibilityResponse

Name	Type	Description	Required
v1beta1CheckCompatibilityResponse	object

v1beta1CreateNamespaceRequest

Name	Type	Required
id	string	Yes
format	SchemaFormat	No
compatibility	SchemaCompatibility	No
description	string	No

v1beta1CreateNamespaceResponse

Name	Type	Description	Required
namespace	v1beta1Namespace		No

v1beta1CreateSchemaResponse

Name	Type	Required
version	integer	No
id	string	No
location	string	No

v1beta1DeleteNamespaceResponse

Name	Type	Description	Required
message	string		No

v1beta1DeleteSchemaResponse

Name	Type	Description	Required
message	string		No

v1beta1DeleteVersionResponse

Name	Type	Description	Required
message	string		No

v1beta1GetLatestSchemaResponse

Name	Type	Description	Required
data	byte		No

v1beta1GetNamespaceResponse

Name	Type	Description	Required
namespace	v1beta1Namespace		No

v1beta1GetSchemaMetadataResponse

Name	Type	Required
format	SchemaFormat	No
compatibility	SchemaCompatibility	No
authority	string	No

v1beta1GetSchemaResponse

Name	Type	Description	Required
data	byte		No

v1beta1ListNamespacesResponse

Name	Type	Description	Required
namespaces	[ string ]		No

v1beta1ListSchemasResponse

Name	Type	Description	Required
schemas	[ string ]		No

v1beta1ListVersionsResponse

Name	Type	Description	Required
versions	[ integer ]		No

v1beta1Namespace

Name	Type	Required
id	string	No
format	SchemaFormat	No
Compatibility	SchemaCompatibility	No
description	string	No
createdAt	dateTime	No
updatedAt	dateTime	No

v1beta1SearchHits

Name	Type	Required
namespaceId	string	No
schemaId	string	No
versionId	integer	No
fields	[ string ]	No
types	[ string ]	No
path	string	No

v1beta1SearchMeta

Name	Type	Description	Required
total	long		No

v1beta1SearchResponse

Name	Type	Description	Required
hits	[ v1beta1SearchHits ]		No
meta	v1beta1SearchMeta		No

v1beta1UpdateNamespaceResponse

Name	Type	Description	Required
namespace	v1beta1Namespace		No

v1beta1UpdateSchemaMetadataResponse

Name	Type	Required
format	SchemaFormat	No
compatibility	SchemaCompatibility	No
authority	string	No

❮Introduction CLI❯

Can you improve this documentation? These fine people already did:
Hari krishna & Ravi SuhagEdit on GitHub

cljdoc builds & hosts documentation for Clojure/Script libraries

Keyboard shortcuts

`Ctrl`+`k`	Jump to recent docs
`←`	Move to previous article
`→`	Move to next article
`Ctrl`+`/`	Jump to the search field

Raise an issue Browse cljdoc source Chat on Slack

× close