The toolbox provides easy to use functions that simplify the process of making requests to the MATLAB Central (MathWorks® Community) APIs. Whether you are using the APIs for data-analysis/reporting or for building custom Node.js apps, the library provides for a smooth integration.
Use of the MATLAB Central Node.js SDK requires:
- Node.js 14 or higher
This SDK supports Node.js versions that are either current, or in long-term support status (LTS). The SDK does not end-of-life (EOL) Node.js versions. For more information on Node.js versioning, see https://nodejs.org/en/about/previous-releases.
This SDK is for use with Node.js only. It does not support other usages, such as for web browsers or frontend applications.
You can quickly install the MATLAB Central Node.js SDK as follows:
npm install matlabcentralTo create a Node.js application using the matlabcentral SDK, do the following:
- Open a new terminal window. Create a new directory for your project and then go to that directory. Alternatively, you could copy the
gettingStarteddirectory inside /examples and proceed to Step 6.
mkdir gettingStarted
cd ./gettingStarted- Use the npm command to create a project definition file (package.json).
npm initAnswer the questions required. You could also take a look at the package.json inside the /examples/gettingStarted directory for help answering any of the questions.
- Install the MATLAB Central SDK package.
npm install matlabcentral- Make sure the package.json that was created has following line, if not include it
"type": "module"
This is required as the SDK only supports ESM imports.
- In your project directory, create a file named gettingStarted.js with the following content:
import MATLABCentral from 'matlabcentral';
async function executeSearch() {
try {
let searchApi = new MATLABCentral.SearchApi();
let opts = {
"query": "plotting",
"scope": "matlab-answers,file-exchange"
}
let searchResponse = await searchApi.search(opts);
console.log("Search API called successfully");
console.log(searchResponse);
} catch (e) {
// e contains two fields:
// e.reason: which is an instance of ApiError which is the formatted JSON with low-level details about the error
// e.error: which is the unformatted error with access to the stack trace, request object, response body, headers and so on
console.log(e.reason);
console.log(e.error);
}
};
executeSearch();Save the gettingStarted.js file.
- Run the script created with the following command
node gettingStarted.jsThe above code creates a new instance of the SearchAPI object using the MATLAB Central SDK and calls the search method.
If the request is successful, the code prints 'Search API called successfully.' along with the result items found, on the terminal.
First, clone this repo locally and cd into the cloned directory.
Next, install dependencies and run tests.
npm install
npm test| Class | Method | HTTP request | Description |
|---|---|---|---|
| SearchApi | search | GET /v1/search | Search MATLAB Central areas for content matching specified query |
The Search collection offers a single method called search which offers a powerful way to programmatically search MATLAB Central.
If you are looking to get data from different MATLAB Central areas like MATLAB Answers, File Exchange, Cody, Community Highlights, Community Contests and Blogs with a single call, this would be the function to use. The function also supports many optional parameters that allow you to further filter the data returned, including limiting the scope to specific MATLAB Central areas.
We are excited to hear any feedback you have for us and welcome contributions in the form of issues.
The license is available in the License file within this repository.
© 2023 The MathWorks, Inc.