React Native

REST URL Encode Path Parts and Query Params

See more REST Examples

When passing a path to a Chilkat REST function, the path parts and query params should be URL encoded. This example explains.. React Native

import { AuthAws, Rest, StringBuilder } from '@chilkat/react-native'

async function chilkatExample() {
  // This example requires the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  // This example demonstrates how to URL encode the path passed to a REST function.
  // It is demonstrated with an Amazon SP API GET request to get details about a listings item for a selling partner.
  // See https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference#getlistingsitem

  const rest = new Rest();

  // Connect to the REST server.
  const bTls = true;
  const port = 443;
  const bAutoReconnect = true;
  await rest.connectAsync('sellingpartnerapi-eu.amazon.com', port, bTls, bAutoReconnect);

  rest.clearAllQueryParams();
  rest.addQueryParam('marketplaceids', 'XYZABC123');
  rest.addQueryParam('includedData', 'offers');

  rest.addHeader('x-amz-access-token', 'YOUR_ACCESS_TOKEN');

  const authAws = new AuthAws();
  authAws.accessKey = 'YOUR_AWS_APP_ID';
  authAws.secretKey = 'YOUR_AWS_APP_SECRET_KEY';
  authAws.region = 'eu-west-1';
  authAws.serviceName = 'execute-api';
  rest.setAuthAws(authAws);

  // The path that is passed to FullRequestNobBody

  // Here's a sample path that is not yet URL encoded.
  const path = '/listings/2022-07-01/items/ABCDEFGHIJ/100x100_28g_LANCETS(BOXED)';

  // The path passed to FullRequestNoBody needs to have the parts URL-encoded.
  // The "/" chars are not URL encoded, but the individual path parts should be URL encoded.
  // For example:  /listings/2022-07-01/items/ABCDEFGHIJ/100x100_28g_LANCETS%28BOXED%29

  // In this case, we'll prepare the path like this:
  const sbPath = new StringBuilder();
  sbPath.append('100x100_28g_LANCETS(BOXED)');
  // URL encode the contents of the sbPath.
  sbPath.encode('url', 'utf-8');
  // Prepend the remaining which does not need to be URL encoded.
  sbPath.prepend('/listings/2022-07-01/items/ABCDEFGHIJ/');

  console.log(`URL encoded path: ${sbPath.getAsString()}`);

  let responseJson: string;
  try {
    responseJson = await rest.fullRequestNoBodyAsync('GET', sbPath.getAsString());
  } catch {
    console.log(rest.lastErrorText);
    return;
  }

  console.log(responseJson);
  console.log('----');
}