Skip to content

Repository contains Node JS Library for communicating with the Aspose.BarCode Cloud API

License

Notifications You must be signed in to change notification settings

aspose-barcode-cloud/aspose-barcode-cloud-node

Repository files navigation

Aspose.BarCode Cloud SDK for Node.js

License Node.js CI npm

  • API version: 4.0
  • Package version: 25.1.0

SDK and API Version Compatibility:

  • SDK Version 25.1 and Later: Starting from SDK version 25.1, all subsequent versions are compatible with API Version v4.0.
  • SDK Version 24.12 and Earlier: These versions are compatible with API Version v3.0.

Demo applications

Scan QR Generate Barcode Recognize Barcode
ScanQR Generate Recognize
Generate Wi-Fi QR Embed Barcode Scan Barcode
Wi-FiQR Embed Scan

Aspose.BarCode for Cloud is a REST API for Linear, 2D and postal barcode generation and recognition in the cloud. API recognizes and generates barcode images in a variety of formats. Barcode REST API allows to specify barcode image attributes like image width, height, border style and output image format in order to customize the generation process. Developers can also specify the barcode type and text attributes such as text location and font styles in order to suit the application requirements.

This repository contains Aspose.BarCode Cloud SDK for Node.js source code.

To use these SDKs, you will need Client Id and Client Secret which can be looked up at Aspose Cloud Dashboard (free registration in Aspose Cloud is required for this).

How to use the SDK

The complete source code is available in this repository folder. You can either directly use it in your project via source code or get nmpjs distribution (recommended).

Install Aspose.BarCode for Cloud via NPM

From the command line:

npm install aspose-barcode-cloud-node --save

Sample usage

The examples below show how your application have to generate QR code and save it on local storage:

const fs = require('fs');
const Barcode = require('aspose-barcode-cloud-node');

const config = new Barcode.Configuration(
    'Client Id from https://dashboard.aspose.cloud/applications',
    'Client Secret from https://dashboard.aspose.cloud/applications',
    null,
    process.env['TEST_CONFIGURATION_ACCESS_TOKEN']
);

async function generateBarcode(api) {
    const request = new Barcode.GenerateRequestWrapper(
        Barcode.EncodeBarcodeType.Qr, 
        'Aspose.BarCode for Cloud Sample');

    const oneBarcode = await api.generate(request);

    const fileName = 'QR.png'
    fs.writeFileSync(fileName, oneBarcode.body);

    return fileName;
}

async function scanBarcode(api, fileName) {

    const scanRequest = new Barcode.ScanMultipartRequestWrapper(fs.readFileSync(fileName));
    const result = await api.scanMultipart(scanRequest);

    return result.body.barcodes;
}

const genApi = new Barcode.GenerateApi(config);
const scanApi = new Barcode.ScanApi(config);

console.log('Generating barcode...');
generateBarcode(genApi)
    .then(fileName => {
        console.log('Barcode saved to ' + fileName);

        console.log('Trying to recognize barcode...');
        scanBarcode(scanApi, fileName)
            .then(barcodes => {
                console.log('Recognized barcodes are:');
                console.log(JSON.stringify(barcodes, null, 2));
            });
    })
    .catch(err => {
        console.error("Error: " + JSON.stringify(err, null, 2));
        process.exitCode = 1;
    });

Every method returns a chainable promise.

Licensing

All Aspose.BarCode for Cloud SDKs, helper scripts and templates are licensed under MIT License.

Resources

Documentation for API Endpoints

All URIs are relative to https://api.aspose.cloud/v4.0/

Class Method HTTP request Description
GenerateApi generate GET /barcode/generate/{barcodeType} Generate barcode using GET request with parameters in route and query string.
GenerateApi generateBody POST /barcode/generate-body Generate barcode using POST request with parameters in body in json or xml format.
GenerateApi generateMultipart POST /barcode/generate-multipart Generate barcode using POST request with parameters in multipart form.
RecognizeApi recognize GET /barcode/recognize Recognize barcode from file on server using GET requests with parameters in route and query string.
RecognizeApi recognizeBase64 POST /barcode/recognize-body Recognize barcode from file in request body using POST requests with parameters in body in json or xml format.
RecognizeApi recognizeMultipart POST /barcode/recognize-multipart Recognize barcode from file in request body using POST requests with parameters in multipart form.
ScanApi scan GET /barcode/scan Scan barcode from file on server using GET requests with parameter in query string.
ScanApi scanBase64 POST /barcode/scan-body Scan barcode from file in request body using POST requests with parameter in body in json or xml format.
ScanApi scanMultipart POST /barcode/scan-multipart Scan barcode from file in request body using POST requests with parameter in multipart form.