API

Version: 0.5.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	Description	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	Description	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	Description	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	Description	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	Description	Required
code	integer		No
message	string		No
details	[ protobufAny ]		No

v1beta1CheckCompatibilityResponse

Name	Type	Description	Required
v1beta1CheckCompatibilityResponse	object

v1beta1CreateNamespaceRequest

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

v1beta1CreateNamespaceResponse

Name	Type	Description	Required
namespace	v1beta1Namespace		No

v1beta1CreateSchemaResponse

Name	Type	Description	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	Description	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	Description	Required
id	string		No
format	SchemaFormat		No
Compatibility	SchemaCompatibility		No
description	string		No
createdAt	dateTime		No
updatedAt	dateTime		No

v1beta1SearchHits

Name	Type	Description	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	Description	Required
format	SchemaFormat		No
compatibility	SchemaCompatibility		No
authority	string		No