blender/flamenco
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update the Javascript instructions for initializing Flamenco's API (#104387)

Browse Source 
Updated to match the current way of initializing API's with `getAPIClient()`

It seems possible the Python instructions might need an update as well.

Reviewed-on: https://projects.blender.org/studio/flamenco/pulls/104387
This commit is contained in:
Vivian Leung 2025-05-06 09:19:43 +02:00 committed by Sybren A. Stüvel
parent 74d96bd02e
commit 190e26adc0
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
web/project-website/content/development/flamenco-api/_index.md
View File

@ -53,10 +53,10 @@ components:
The JavaScript code for the web-application will look something like this:
```JavaScript
import { apiClient } from '@/stores/api-query-count';
import { MetaApi } from "@/manager-api";
import { getAPIClient } from '@/api-client';
import * as API from "@/manager-api";
const metaAPI = new MetaApi(apiClient);
const metaAPI = new API.MetaApi(getAPIClient());
metaAPI.getVersion()
.then((version) => {
this.flamencoName = version.name;
@ -69,17 +69,17 @@ metaAPI.getVersion()
This follows a few standard steps:
1. **Import the `apiClient`**. For the web-app, this actually is a little wrapper
1. **Import `getAPIClient`**. For the web-app, this actually is a little wrapper
for the actual API client. The wrapper takes care of showing a "loading"
spinner in the top-right corner when API calls take a long time to return a
response.
2. **Import the API class** that contains this operation. This always has the form
`{tag}Api`, where `{tag}` comes from the `tag: ...` in the OpenAPI YAML
file. In our case, the tag is `meta`, so the code imports `MetaApi`.
3. **Construct the API object** with `new MetaApi(apiClient)`. You only have to
3. **Construct the API object** with `new MetaApi(getAPIClient())`. You only have to
do this once; after that you can call as many functions on it as you want.
4. **Call** the function. The function name comes from the `operationId` in the YAML
file,
file.
5. **Handle** the succesful return (`.then(...)`) and any errors (`.catch(...)`).
All API function calls, like the `metaAPI.getVersion()` function above,