Skip to content

mksms/mksms-javascript

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mksms

npm version license

This is the mksms API implement in js to make it easy to use.

Table of contents

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

You need an API_KEY and API_HASH, get them on our website https://mksms.cm

Installing

To install the package run

    $npm i mksms

Use package

To use the package you must first import it. here is an example of import.

Import in nodejs

    const mksms = require('mksms');

or

    const {Client, Message, Contact} = require('mksms');

Use

    const config = {
        api_key:"MY_API_KEY",
        api_hash:"MY_API_HASH"
    };
    let client = new mksms.Client(config.api_key,config.api_hash);

    client.send_message({
        to:{
            number:"+237692392932",
            name:"jean"
            },
        body:"hello"
    }).subscribe({
        error:(error)=>{
          //do any thing
        },
        next:(data)=>{
            //do any thing
        },
        complete:(rep)=>{
            //do any thing
        }
    });

or

    var config = {
        api_key:"MY_API_KEY",
        api_hash:"MY_API_HASH"
    };
    var contact = new Contact("+237692392932","jean");
    var message = new Message(contact,"hello");
    var client = new Client(config.api_key,config.api_hash);
    client.send_message(message);

Test

This must be done to test the configurations and the proper functioning of the API.

Launch the test

    $npm test

or to view test results in the browser

    $npm run test:browser

Set up the tests

You can change the test configuration in the ./test/data/data.json file.

    {
        "test_config":{
            "api_key": "BDCAA0C858",
            "api_hash": "f7e88b92f324bdd09d195019053a2d613c3ae6c5b1dcadf988c2b18e75770530"
        },
        "fake_message":{
            "to":{
                "number":"697898466f",
                "name":"moi"
            },
            "body":"Salut molah"
        },
        "good_message" :{
            "to":{
                "number":"697898466",
                "name":"moi"
            },
            "body":"Salut molah"
        }
    }

or directly from the command line

    $npm run test --key="MY_API_KEY" --hash="MY_API_HASH" --number="number" --name="name" --body="message"

Test results

In the console

test_mksms_console_result

In the browser

test_mksms_browser_result

NB: the api test fails if api_key and api_hash are not valid.

Methods docs

Get messages

  • name: get_messages
Params Type Default value Required
min_date Date null not required
direction number -1 not required
read boolean false not required
timestamp Date null not required
  • return: Observable< Array >
   []

Send messages

  • name: send_messages
Params Type Default value Required
message Message true
  • return: Observable< Object >
   {
     "success": true,
     "cost": 1
   }

or there is an error

  {
     "success": false,
     "message": "Invalid ..."
  }

Start verify

  • name: start_verify
Params Type Default value Required
number string true
name string true
  • return: Observable< Object>
   {
     "success": true
   }

or there is an error

  {
     "success": false,
     "message": "Invalid ..."
  }

Confirm verify

  • name: confirm_verify
Params Type Default value Required
number string true
code string true
  • return: Observable< Object >
   {
     "success": true
   }

or there is an error

  {
     "success": false,
     "message": "Invalid ..."
  }

Authors

  • Eugene Fezeu - Initial work - @fez2000

License

This project is licensed under the Apache 2.0 License - see the LICENSE.md file for details