Not able to invoke the plugin - Where should I see the documentation?

I have enabled the plugin on services and route, but unable to view the spec.

I am using kong 2.0 version. What am I missing?

Hi,

my swagger documentation full url is http://apidns:port/documentation.

I configured plug in at global level with swagger documentation url which is
spec url : http://apidns:port/documentation.

When I call same url http://kongdns:port/documentation from browser, it says route not found.

How do I configure and invoke documentation

Hi there,

I'm trying plugin on a docker kong instance, I've configured the plugin using the steps posted here, and I've created my endpoint by bellow command:

curl -s -X POST http://10.200.10.1:8001/services -d name=partners -d url=http://partners:8080/partners
curl -s -X POST http://10.200.10.1:8001/services/partners/routes -d name=partRoute -d "paths[]=/partners"
curl -X POST http://10.200.10.1:8001/services/partners/plugins \
    	--data "name=kong-spec-expose"  \
    	--data "config.spec_url=http://partners:9080/api-docs"

However, when I hit the endpoint adding /specz termination, it responses:

curl -X GET http://10.200.10.1:8000/partners/specz
{"message":"An unexpected error occurred"}

Partners microservice exposes its API documentation on this url: http://partners:9080/api-docs.

I'm running Kong 5.1. Kong's log just show this:

kong        | 172.26.0.1 - - [30/Jan/2020:17:23:31 +0000] "GET /partners/specz HTTP/1.1" 500 42 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.130 Safari/537.36"
kong        | 2020/01/30 17:28:16 [warn] 30#0: *7176 [kong] plugins.lua:164 DEPRECATED: /plugins/schema/:name endpoint is deprecated, please use /schemas/plugins/:name instead., client: 172.26.0.1, server: kong_admin, request: "GET /plugins/schema/kong-spec-expose?size=1000 HTTP/1.1", host: "localhost:8001"

I was wondering if there is something wrong with my configuration.
Thanks

Hello,

So I managed to install the plugin, created the following service:

POST request to https://localhost:8443/admin-api/services
with this JSON body:

{
    "name":"OrdersController",
    "host":"orders-microservice",
    "path":"/api/v1/orders"
}

Note: I secured Kong's Admin API by creating a loopback route, that is why you see admin-api/ there.

Then I added the following route with this POST request:
https://localhost:8443/admin-api/routes
...and this JSON body:

{
  "name":"v1-orders",
  "protocols": ["https"],
  "methods": ["GET","POST","PUT","DELETE"],
  "paths": ["/api/v1/orders"],
  "service": {
      "id": "<ID returned on previous response>"
  }
}

The plugin was added to the route above and the spec URL added was http://localhost:8080/swagger/v1/swagger.json

However, when I send a GET request to https://localhost:8443/api/v1/orders/specz I receive the following error:

{
    "message": "An unexpected error occurred"
}

What am I doing wrong?

Hi - I've exposed a swagger endpoint using the kong-spec-expose plugin, but the server address in the swagger document is still the upstream url, not the kong url. Is there a way to substutute this for the kong url? Thanks.

Hi All,

Referring to this link https://docs.konghq.com/hub/optum/kong-spec-expose/
how to configure this plugin if its a k8s cluster which is connecting via KUBCONFIG from windows machine? please share insights here.
(kong version is 2.8)

$ ./luarocks make *.rockspec
Warning: Could not find Lua 5.4 in PATH.
Modules may not install with the correct configurations. You may want to configure the path prefix to your build of Lua 5.4 using

luarocks config --local lua_dir

Error: Failed finding Lua header files. You may need to install them or configure LUA_INCDIR.

I have use kong version 2.0.4.
and I face the following error.

{
"message": "schema violation (name: plugin 'kong-spec-expose' not enabled; add it to the 'plugins' configuration property)",
"name": "schema violation",
"fields": {
"name": "plugin 'kong-spec-expose' not enabled; add it to the 'plugins' configuration property"
},
"code": 2
}

I follow the given steps in the following doc.
https://docs.konghq.com/hub/optum/kong-spec-expose/

Is this compatible with the latest kong release v2.