Node. Make your first call.
Install the official Node client and bring ParseAPI into your code.
Official Node SDK
npm install @parseapi/sdkYour language. The same ParseAPI.
Get connected
One country. Your first request.
Look up the United States and print its name.
Install the library.
npm install @parseapi/sdkAdd your secret key.
Create a secret key in Keys. Set it in the terminal that will run the example. Keep it on your server.
export PARSEAPI_KEY='YOUR_API_KEY'Make a request.
Save this as example.mjs, then run it. This lookup uses your plan's request allowance.
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI(); // Reads PARSEAPI_KEY.
const country = await parse.country('US');
console.log(country.name);node example.mjsUnited StatesHandle API errors
Read the error code and request ID when an API request fails. Branch on the code, such as not_found, rather than the message. A response with valid: false is a successful lookup. Transport failures still propagate.
import { parseAPI, ParseAPIError } from '@parseapi/sdk';
const parse = parseAPI(); // Reads PARSEAPI_KEY.
try {
const country = await parse.country('US');
console.log(country.name);
} catch (error) {
if (error instanceof ParseAPIError) {
console.error(error.code, error.status, error.requestId);
}
throw error;
}Requests and retries
SDK methods follow the API routes. Unknown response values stay unknown, rather than becoming empty strings or guesses.
Ordinary lookups retry temporary failures. Separately metered checks make one attempt by default. You can configure the retry count. See the retry policy.