I would like to be able to use swagger-client
to create a moviedb node client. It kinda works:
const Swagger = require('swagger-client');
...
mdbClient = new Swagger({
url: 'https://api.stoplight.io/v1/versions/9WaNJfGpnnQ76opqe/export/oas.json',
usePromise: true,
authorizations: {
api_key: new Swagger.ApiKeyAuthorization('api_key', config.movieDbKey, 'query'),
},
});
....
mdbClient
.then(client => {
return client.apis.default.GET_tv_tv_id({ tv_id: mdbShowId, append_to_response: 'videos' })
})
.then(result => {
return result.obj
});
which does return the show object. The problem is that it doesn't return the videos, which you'd expect from the append_to_response
argument.
When I look at the OAS doc at https://api.stoplight.io/v1/versions/9WaNJfGpnnQ76opqe/export/oas.json:
"/tv/{tv_id}": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
but when I look at the api docs on the site, the append_to_reponse
argument is defined.
So why is whatever swagger docs are generating the onsite api different from what we get at: https://api.stoplight.io/v1/versions/9WaNJfGpnnQ76opqe/export/oas.json
Can't find a movie or TV show? Login to create it.
Vil du vurdere eller legge til dette elementet i en liste?
Ikke et medlem?
Svar av Travis Bell
den 27 Mars 2018 kl. 12:21 AM
Hi @moviebuff2022, I'm not sure. Our docs are generated by Stoplight and I don't have much knowledge about any of the particular things around how the params and docs connect up in the OAS file. I just enter data in their UI
I'll send them a support ticket tomorrow and see what they say. In the docs editor you can see here how the two sections are split.
Svar av moviebuff2022
den 27 Mars 2018 kl. 12:28 AM
Hi Travis,
Yeah, the docs on the site are definitely correct, what I don't understand is why https://api.stoplight.io/v1/versions/9WaNJfGpnnQ76opqe/export/oas.json is different. It just doesn't have the
append_to_reponse
parameter (or language for that matter) defined.Thanks for the speedy response. Let's see what they say.
Svar av shantmarouti
den 17 November 2018 kl. 11:54 PM
@travisbell I think you need to update the URL of the oas.json. Seems like it contains version string.
Svar av Travis Bell
den 18 November 2018 kl. 12:37 AM
Hi @shantmarouti Thanks for stopping by. As I mentioned above, I don’t generate or control any of that. It’s all controlled by Stoplight.
Unfortunately, Stoplight isn’t supporting the version of the docs we’re using so it’s not likely to get fixed until I spend time upgrading to their new platform.
Svar av metlhead05
den 11 Desember 2020 kl. 9:13 PM
I found some additional pieces that are pretty out of sync. for instance in movie/search there are 7 possible input params: language, query, page, include_adult, region, year, primary_release_year. In the JSON OAS spec, there are only 2 params: year, primary_release_year