isaacj@stat1008:~$ curl "https://recommendation-api-ng.k8s-ml-staging.discovery.wmnet:31443/api/?s=en&t=fr&n=3&article=Apple" -A "isaac@wikimedia.org - test" --http1.1

(first time, just hung for ~10 seconds before I killed; second time, now I get "no healthy upstream" immediately for any call so apologies if that was my doing)

isaacj@stat1008:~$ cat input.json
{
    "s": "en",
    "t": "fr",
    "n": 6
    "article": "Apple"
}
isaacj@stat1008:~$ curl "https://recommendation-api-ng.k8s-ml-staging.discovery.wmnet:31443/api/" -X POST -d @input.json -A "isaac@wikimedia.org - test" --http1.1

(got something about POST not being allowed I think)

elukey@stat1004:~$ curl "https://recommendation-api-ng.discovery.wmnet:31443/api/spec" -i --http1.1
HTTP/1.1 200 OK
content-type: application/json
content-length: 1908
access-control-allow-origin: *
access-control-allow-headers: Content-Type,Authorization
access-control-allow-methods: GET
x-envoy-upstream-service-time: 8
date: Tue, 03 Oct 2023 15:51:09 GMT
server: istio-envoy

{"basePath":"/api","consumes":["application/json"],"definitions":{"Article":{"properties":{"pageviews":{"description":"pageviews","type":"integer"},"rank":{"description":"rank","type":"number"},"title":{"description":"title","type":"string"},"wikidata_id":{"description":"wikidata_id","type":"string"}},"required":["rank","title","wikidata_id"],"type":"object"}},"info":{"title":"API","version":"1.0"},"paths":{"/":{"get":{"deprecated":true,"description":"Gets recommendations of source articles that are missing in the target","operationId":"get_legacy_article","parameters":[{"description":"Source wiki project language code","in":"query","name":"s","required":true,"type":"string"},{"description":"Target wiki project language code","in":"query","name":"t","required":true,"type":"string"},{"default":12,"description":"Number of recommendations to fetch","in":"query","maximum":24,"minimum":0,"name":"n","type":"integer"},{"description":"Seed article for personalized recommendations that can also be a list separated by \"|\"","in":"query","name":"article","pattern":"^([^|]+(\\|[^|]+)*)?$","type":"string"},{"default":true,"description":"Whether to include pageview counts","in":"query","name":"pageviews","type":"boolean"},{"collectionFormat":"multi","default":"morelike","description":"Which search algorithm to use if a seed is specified","enum":["morelike","wiki"],"in":"query","name":"search","type":"string"}],"responses":{"200":{"description":"Success","schema":{"items":{"$ref":"#/definitions/Article"},"type":"array"}}},"tags":["default"]}},"/spec":{"get":{"operationId":"get_spec","responses":{"200":{"description":"Success"}},"tags":["default"]}}},"produces":["application/json"],"responses":{"MaskError":{"description":"When any error occurs on mask"},"ParseError":{"description":"When a mask can't be parsed"}},"swagger":"2.0","tags":[{"description":"Default namespace","name":"default"}]}

$ time curl -s "https://api.wikimedia.org/service/lw/recommendation/v1/api/?s=en&t=fr&n=3&article=France"  |jq .

[
  {
    "pageviews": 1831,
    "title": "Turks_in_Europe",
    "wikidata_id": "Q4821600",
    "rank": 498.0
  },
  {
    "pageviews": 3271,
    "title": "European_emigration",
    "wikidata_id": "Q3819571",
    "rank": 496.0
  },
  {
    "pageviews": 790,
    "title": "History_of_France_(1900–present)",
    "wikidata_id": "Q290313",
    "rank": 476.0
  }
]

real	0m4.985s
user	0m0.072s
sys	0m0.008s

{
  "basePath": "/api",
  "consumes": [
    "application/json"
  ],
  "definitions": {
    "Article": {
      "properties": {
        "pageviews": {
          "description": "pageviews",
          "type": "integer"
        },
        "rank": {
          "description": "rank",
          "type": "number"
        },
        "title": {
          "description": "title",
          "type": "string"
        },
        "wikidata_id": {
          "description": "wikidata_id",
          "type": "string"
        }
      },
      "required": [
        "rank",
        "title",
        "wikidata_id"
      ],
      "type": "object"
    }
  },
  "info": {
    "title": "API",
    "version": "1.0"
  },
  "paths": {
    "/": {
      "get": {
        "deprecated": true,
        "description": "Gets recommendations of source articles that are missing in the target",
        "operationId": "get_legacy_article",
        "parameters": [
          {
            "description": "Source wiki project language code",
            "in": "query",
            "name": "s",
            "required": true,
            "type": "string"
          },
          {
            "description": "Target wiki project language code",
            "in": "query",
            "name": "t",
            "required": true,
            "type": "string"
          },
          {
            "default": 12,
            "description": "Number of recommendations to fetch",
            "in": "query",
            "maximum": 24,
            "minimum": 0,
            "name": "n",
            "type": "integer"
          },
          {
            "description": "Seed article for personalized recommendations that can also be a list separated by \"|\"",
            "in": "query",
            "name": "article",
            "pattern": "^([^|]+(\\|[^|]+)*)?$",
            "type": "string"
          },
          {
            "default": true,
            "description": "Whether to include pageview counts",
            "in": "query",
            "name": "pageviews",
            "type": "boolean"
          },
          {
            "collectionFormat": "multi",
            "default": "morelike",
            "description": "Which search algorithm to use if a seed is specified",
            "enum": [
              "morelike",
              "wiki"
            ],
            "in": "query",
            "name": "search",
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "items": {
                "$ref": "#/definitions/Article"
              },
              "type": "array"
            }
          }
        },
        "tags": [
          "default"
        ]
      }
    },
    "/spec": {
      "get": {
        "operationId": "get_spec",
        "responses": {
          "200": {
            "description": "Success"
          }
        },
        "tags": [
          "default"
        ]
      }
    }
  },
  "produces": [
    "application/json"
  ],
  "responses": {
    "MaskError": {
      "description": "When any error occurs on mask"
    },
    "ParseError": {
      "description": "When a mask can't be parsed"
    }
  },
  "swagger": "2.0",
  "tags": [
    {
      "description": "Default namespace",
      "name": "default"
    }
  ]
}