panic: spec type not supported by libopenapi, sorry

[alexanderilyin]

It seems that restish does not work with openapi: 3.1.0. I might be wrong tho, still digging.

I'm trying to hack several things together so I have a convenient environment, main parts are:

• https://world.openfoodfacts.net — Public HTTP API, it's kinda OpenAPI but missing few pieces here and there.
• restish — best tool in known universe for peeking on HTTP APIs.
• docs/api/ref/ — directory with API specs which I try to have locally so restish could give me nice CLI UX.

Below are the main steps I'm currently following:

1. Clone repo with API specs:

git clone https://github.com/openfoodfacts/openfoodfacts-server.git /tmp/openfoodfacts-server

2. Configure restish to use local specs:

{
  "$schema": "https://rest.sh/schemas/apis.json",
  "openfoodfacts": {
    "base": "https://world.openfoodfacts.net/api/v2",
    "spec_files": ["/workspaces/amp-python/openfoodfacts.yaml"],
    "profiles": {
      "default": {
        "auth": {
          "name": ""
        }
      }
    },
    "tls": {}
  }
}

3. Watch my hopes and dreams burn:

$ restish openfoodfacts --help
panic: spec type not supported by libopenapi, sorry

goroutine 1 [running]:
github.com/rest-sh/restish/cli.Run()
        /go/pkg/mod/github.com/rest-sh/restish@v0.21.0/cli/cli.go:822 +0xf45
main.main()
        /go/pkg/mod/github.com/rest-sh/restish@v0.21.0/main.go:40 +0x245

I'm somewhat interested in two options:

1. Suggestions on where to apply duct tape to make it work at least locally.
2. Suggestions on how to fix it in upstream.

Meanwhile I will try to downgrade specs to v2.

[alexanderilyin]

My bad, one of the issues was a layer 8 problem:

-"spec_files": ["/workspaces/amp-python/openfoodfacts.yaml"],
+"spec_files": ["/tmp/openfoodfacts-server/docs/api/ref/api.yaml"],

openfoodfacts.yaml was an empty file, once replaces with actual spec file it Just Works™.

$ restish openfoodfacts get-product-by-barcode 00635738
HTTP/2.0 200 OK
Access-Control-Allow-Headers: DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,If-None-Match,Authorization
Access-Control-Allow-Methods: HEAD, GET, PATCH, POST, PUT, OPTIONS
Access-Control-Allow-Origin: *
Access-Control-Expose-Headers: Content-Length,Content-Range
Content-Type: application/json; charset=utf-8
Date: Sun, 14 Sep 2025 01:44:32 GMT
Server: nginx/1.23.1
X-Content-Type-Options: nosniff
X-Download-Options: noopen
X-Request-Id: DUOufajOQBWI0APA
X-Xss-Protection: 1; mode=block

{
  code: "00635738"
  product: {
    _id: "00635738"