Support Questions
Find answers, ask questions, and share your expertise
Announcements
Alert: Welcome to the Unified Cloudera Community. Former HCC members be sure to read and learn how to activate your account here.

Schema Registry REST API Reference - Link does not work - HDF 3.0.0

SOLVED Go to solution
Highlighted

Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

Hello. I am referencing the Schema Registry overview article at this location - https://docs.hortonworks.com/HDPDocuments/HDF3/HDF-3.0.0/bk_overview/content/ch04s01.html

In the section called "Schema Registry API" is a link to the Schema Registry REST API Reference document. The "Schema Registry REST API Reference" link does not work

Schema Registry API

You can view the full API details included in the Schema Registry REST API Reference document included in this Technical Preview release.

You can view the full API details in the Schema Registry REST API Reference documentation.

When you click the link you receive this error:

<Error> <Code>NoSuchKey</Code> <Message>The specified key does not exist.</Message>

"); vertical-align: bottom; height: 10px;"><Key> HDPDocuments/HDF3/HDF-3.0.0/bk_schema-registry-rest-api-reference/content/index.html </Key>
<RequestId>44BD194720EA0DED</RequestId>
"); vertical-align: bottom; height: 10px;"><HostId> Mmz9LphnoNedL/By94JBQoE2RedYdeljwKq44kyQq3dPKO85mglKhPgZ2WhBRYXGStC5UQyId5I= </HostId>

</Error>

Has anyone found an updated link to the API reference?

1 ACCEPTED SOLUTION

Accepted Solutions

Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

Hi Kirk,

Thanks for raising this. I work on the Schema Registry documentation and I'll investigate the error. I'll update this thread once I have the link working!

12 REPLIES 12

Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

Hi Kirk,

Thanks for raising this. I work on the Schema Registry documentation and I'll investigate the error. I'll update this thread once I have the link working!

Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

Hello Sarah. Any updates on when the link will be working? Thanks

Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

I'm also looking for documentation Found the below in the registry log which will help while Sarah works on that broken link.

Example:

curl http://localhost:7788/api/v1/schemaregistry/schemas

GET  /api/swagger  
GET  /api/swagger.{type:json|yaml}  
POST /api/v1/schemaregistry/files  
GET  /api/v1/schemaregistry/files/download/{fileId}  
GET  /api/v1/schemaregistry/schemaproviders  
GET  /api/v1/schemaregistry/schemas  
POST /api/v1/schemaregistry/schemas  
GET  /api/v1/schemaregistry/schemas/aggregated  
GET  /api/v1/schemaregistry/schemas/{name}  
GET  /api/v1/schemaregistry/schemas/{name}/aggregated  
POST /api/v1/schemaregistry/schemas/{name}/compatibility  
POST /api/v1/schemaregistry/schemas/{name}/mapping/{serDesId}  
GET  /api/v1/schemaregistry/schemas/{name}/serdes  
GET  /api/v1/schemaregistry/schemas/{name}/versions  
POST /api/v1/schemaregistry/schemas/{name}/versions  
GET  /api/v1/schemaregistry/schemas/{name}/versions/latest  
POST /api/v1/schemaregistry/schemas/{name}/versions/upload  
GET  /api/v1/schemaregistry/schemas/{name}/versions/{version}  
GET  /api/v1/schemaregistry/schemasById/{schemaId}  
GET  /api/v1/schemaregistry/search/schemas  
GET  /api/v1/schemaregistry/search/schemas/aggregated  
GET  /api/v1/schemaregistry/search/schemas/fields  
POST /api/v1/schemaregistry/serdes  
GET  /api/v1/schemaregistry/serdes/{id}  

Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

You can access the Schema Registry API Swagger documentation directly from the UI itself.

To do this, append your URL with: /api/swagger/

For example: http://localhost:9090/api/swagger/

Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

Thanks this does work for us. Our port is different but I was able to see the api reference.

Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

Any news on this? The link in the documentation still does not work (

https://docs.hortonworks.com/HDPDocuments/HDF3/HDF-3.0.0/bk_schema-registry-rest-api-reference/conte..., and at least on my installation (HDP 2.6.4 and HDF 3.0.2), I am unable to see the swagger documentation under the endpoint /api/swagger. The response is:

{"responseMessage":"An exception with message [HTTP 404 Not Found] was thrown while processing request.}

Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

I run into the same issue when I try to access the swagger documentation via /api/swagger. My current workaround is to reference the Confluent schema registry API docs here. The APIs aren't an exact 1:1 match, but many of the API calls are the same, so I was able to use that.

Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

Hi!

I using SchemaRegistry version 0.5.1. I want develop python schema client, so I want to see REST API. But when i using url like http://localhost:9090/api/swagger/ it return " .

Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0

New Contributor

After way too much struggling with the same issue, I was finally able to find the REST API URL. It was at http://localhost:<port>/swagger/. My Schema Registry was running on port 7788, so I could hit it from http://localhost:7788/swagger/ (remove the "/api" part of the url)