question Re: Schema Registry REST API Reference - Link does not work - HDF 3.0.0 in Support Questions

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

kirk_demumbrane — Thu, 29 Jun 2017 03:46:12 GMT

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>

"); vertical-align: bottom; height: 10px;"><HostId> Mmz9LphnoNedL/By94JBQoE2RedYdeljwKq44kyQq3dPKO85mglKhPgZ2WhBRYXGStC5UQyId5I= </HostId>

</Error>

Has anyone found an updated link to the API reference?

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

solson — Thu, 29 Jun 2017 03:52:42 GMT

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

bjorn_olsen — Mon, 03 Jul 2017 21:26:13 GMT

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

kirk_demumbrane — Wed, 09 Aug 2017 22:44:30 GMT

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

solson — Thu, 10 Aug 2017 01:37:01 GMT

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

kirk_demumbrane — Thu, 10 Aug 2017 21:05:17 GMT

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

janecek — Mon, 12 Feb 2018 21:59:07 GMT

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/content/index.html#/schemaregistry), 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

qhuy_duong — Thu, 05 Apr 2018 11:43:30 GMT

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

travis_munn — Fri, 06 Apr 2018 22:55:52 GMT

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

travis_munn — Sat, 14 Apr 2018 01:15:20 GMT

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)

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

qhuy_duong — Sun, 15 Apr 2018 09:58:44 GMT

Thanks, it work!. Please note to new version when change url.

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

oscarandreu — Wed, 18 Apr 2018 14:24:36 GMT

Thanks, it works!

Thanks, It works!

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

qq349074225 — Thu, 11 Apr 2019 00:43:11 GMT

If "/api/swagger" not working, try "/swagger" instead.