axios-api-request v1.0.1

axios-api-request

This package creates an axios handler that helps facilitate requests to endpoints with a single instance for all.

Table of Contents

• Installation
• Quick use
• Methods reference
  • get()
  • post()
  • put()
  • patch()
  • delete()
• Data Types
  • ConfigResponseDataType
  • ConfigResponseTypes
• Resources
• License

Installation

Using npm:

  npm i -D axios-api-request

  npm install --save-dev axios-api-request

Using yarn:

  yarn add axios-api-request -D

  yarn add axios-api-request --dev

Quick use

This line of code generates the same instance for all requests. This makes it easier to work with requests to an API, since the baseUrl is only declared once in this file and the methods make use of this configuration.

• Sample:

  It is important to call 'AxiosApiRequest.init' from a high-level input file that is called only once so as not to overwrite the installation

  index.js - It could be any other input file

    import AxiosApiRequest from "axios-api-request";
  
    const main = () => {
      AxiosApiRequest.init({
        baseURL: "https://my-url-api/api",
        headers: { "Content-Type": "text/html" }
        timeout: 20000
      });
  
      // Do something...
    }

  From another file, we can make a request with traditional http methods. This retrieves the instance created in the entry file.

  other.js

    import AxiosApiRequest from "axios-api-request";
  
    const myApiRequest = async () => {
      const client = AxiosApiRequest.getClient();
      const response = await client.get("/something");
  
      /*
        * Generate a request in the following way
        axios.request({
          baseURL: 'https://my-url-api/api',
          method: 'GET',
          url: '/something',
          headers: { "Content-Type": "text/html" },
          timeout: 20000
        });
  
        * Returns the service response without having to access 'data' from the axios response
        response = { ... }
      */
  
      // Do something...
    }

It is also possible to overwrite the value of a specified property in the config of the 'init' method and add new values.

  import AxiosApiRequest from "axios-api-request";

  const myApiRequest = async () => {
    const client = AxiosApiRequest.getClient();
    const response = await client.post(
      "/product/1",
      { name: "example", id: "k39-123nb19319-asdcloj234" },
      {
        headers: { Connection: "Keep-Alive", "Content-Type": "application/json" },
        timeout: 40000
      }
    );

    /*
      * Generate a request in the following way
      axios.request({
        baseURL: 'https://my-url-api/api',
        method: 'POST',
        url: '/product/1',
        headers: { Connection: "Keep-Alive", "Content-Type": "application/json" },
        data: { name: "example", id: "k39-123nb19319-asdcloj234" },
        timeout: 40000
      });

      * Returns the service response without having to access 'data' from the axios response
      response = { ... }
    */

    // Do something...
  }

Please review the tests of each of the methods in the tests to get a clearer idea of ​​the capabilities of their use.

Methods reference

Description of each of the methods. To use each of these methods, you must first call 'AxiosApiRequest.init' to generate the instance with axios.

The current instance to use the following methods must first be recovered as follows:

  const client = AxiosApiRequest.getClient();

• client.get(url, config, configResponse)
• client.post(url, data, config, configResponse)
• client.put(url, data, config, configResponse)
• client.patch(url, data, config, configResponse)
• client.delete(url, config, configResponse)

get()

  client.get(url, config, configResponse)

  // Sample
  const client = AxiosApiRequest.getClient();
  const response = await client.get(
    "/products",
    { headers: { "X-Requested-With": "XMLHttpRequest" } },
    ["headers"]
  );

  /*
    response = {
      data: { ... }, -> response that the service returns
      headers: { ... } -> headers that the service returns
    };
  */

The traditional 'GET' method of http with some improvements

Parameters:

post()

  client.post(url, data, config, configResponse)

  // Sample
  const client = AxiosApiRequest.getClient();
  const response = await client.post(
    "/product/1",
    { name: "example", id: "k39-123nb19319-asdcloj234" },
    { headers: { "Content-Type": "application/json" } },
    ["headers", "status"]
  );

  /*
    response = {
      data: { ... }, -> response that the service returns
      headers: { ... } -> headers that the service returns
      status: { ... } -> status that the service returns
    };
  */

The traditional 'POST' method of http with some improvements

Parameters:

put()

  client.put(url, data, config, configResponse)

  // Sample
  const client = AxiosApiRequest.getClient();
  const response = await client.put(
    "/product/1",
    { name: "example", id: "k39-123nb19319-asdcloj234" },
    { headers: { "Content-Type": "application/json" } },
    ["headers", "status"]
  );

  /*
    response = {
      data: { ... }, -> response that the service returns
      headers: { ... } -> headers that the service returns
      status: { ... } -> status that the service returns
    };
  */

The traditional 'PUT' method of http with some improvements

Parameters:

patch()

  client.patch(url, data, config, configResponse)

  // Sample
  const client = AxiosApiRequest.getClient();
  const response = await client.patch(
    "/product/1",
    { name: "example", id: "k39-123nb19319-asdcloj234" },
    { headers: { "Content-Type": "application/json" } },
    ["headers", "status"]
  );

  /*
    response = {
      data: { ... }, -> response that the service returns
      headers: { ... } -> headers that the service returns
      status: { ... } -> status that the service returns
    };
  */

The traditional 'PATCH' method of http with some improvements

Parameters:

delete()

  client.delete(url, config, configResponse)

  // Sample
  const client = AxiosApiRequest.getClient();
  const response = await client.delete(
    "/products",
    { headers: { "X-Requested-With": "XMLHttpRequest" } },
    ["headers"]
  );

  /*
    response = {
      data: { ... }, -> response that the service returns
      headers: { ... } -> headers that the service returns
    };
  */

The traditional 'DELETE' method of http with some improvements

Parameters:

Data Types

These types can be destructured from the package to be used in their interfaces.

ConfigResponseDataType

Array of type ConfigResponseTypes with the name of the attributes that the request could return. By default it always returns the content of 'data', review Axios response schema for more information.

ConfigResponseTypes

Name of elements that can be returned in the request response or error, review Axios response schema for more information.

Interface:

Resources

• Changelog
• Tests

License

MIT