Awesome

<div align="center" style="text-align: center"> <p><a href="https://github.com/weyoss/redis-smq-rest-api"><img alt="RedisSMQ" src="./logo.png?v=202312182134" /></a></p> <p>A RESTful API for RedisSMQ</p> <p> <a href="https://github.com/weyoss/redis-smq-rest-api/actions/workflows/tests.yml"><img src="https://github.com/weyoss/redis-smq-rest-api/actions/workflows/tests.yml/badge.svg" alt="Tests" style="max-width:100%;" /></a> <a href="https://github.com/weyoss/redis-smq-rest-api/actions/workflows/codeql.yml" rel="nofollow"><img src="https://github.com/weyoss/redis-smq-rest-api/actions/workflows/codeql.yml/badge.svg" alt="Code quality" /></a> <a href="https://codecov.io/github/weyoss/redis-smq-rest-api?branch=master" rel="nofollow"><img src="https://img.shields.io/codecov/c/github/weyoss/redis-smq-rest-api" alt="Coverage Status" /></a> <a href="https://npmjs.org/package/redis-smq-rest-api" rel="nofollow"><img src="https://img.shields.io/npm/v/redis-smq-rest-api.svg" alt="NPM version" /></a> </p> </div>

RedisSMQ REST API

RedisSMQ REST API offers an HTTP interface which allows any web capable application to interact with the RedisSMQ message queue using a RESTful API.

Currently, RedisSMQ REST API is distributed as an RC release and is still in active development.

To start using the REST API make sure that you are using the latest RedisSMQ V8 RC release.

Features

A clean and simple implementation as always :).
Strict Request/Response validation based on JSON Schema.
Native OpenAPI v3 support and Swagger for developers.
Rigorously tested codebase with code coverage no less than 90%.
Both ESM & CJS modules are supported.

Installation

npm i redis-smq-rest-api@rc --save

Configuration

The REST API configuration extends RedisSMQ Configuration while adding the API server configuration.

interface IApiServerConfig {
  port?: number;
  hostname?: string;
  basePath?: string;
}

interface IRedisSMQHttpApiConfig extends IRedisSMQConfig {
  apiServer?: IApiServerConfig;
}

Usage

import { IRedisSMQHttpApiConfig, RedisSMQRestApi } from 'redis-smq-rest-api';

const config: IRedisSMQHttpApiConfig = {
    redis: {
        client: ERedisConfigClient.IOREDIS,
        options: {
            host: '127.0.0.1',
            port: 6379,
        },
    },
    apiServer: {
        host: '127.0.0.1',
        port: 7210
    }
};

const apiServer = new RedisSMQRestApi(config);
apiServer.run();

API Reference

Once your RedisSMQ API server is up and running you may view the API Reference and try it directly from the Swagger UI which is accessible via http://<HOSTAME:PORT>/docs.

OpenAPI Specification

The OpenAPI specification is available at http://<HOSTAME:PORT>/assets/openapi-specs.json