NAME

    WebService::Mocean - Perl library for integration with MoceanSMS
    gateway, https://moceanapi.com.

SYNOPSIS

      use WebService::Mocean;
      my $mocean_api = WebService::Mocean->new(api_key => 'foo', api_secret => 'bar');

DESCRIPTION

    WebService::Mocean is Perl library for integration with MoceanSMS
    gateway, https://moceanapi.com.

DEVELOPMENT

    Source repo at https://github.com/kianmeng/webservice-mocean.

 Docker

    If you have Docker installed, you can build your Docker container for
    this project.

        $ docker build -t webservice-mocean .
        $ docker run -it -v $(pwd):/root webservice-mocean bash
        # cpanm --installdeps --notest .

 Milla

    Setting up the required packages.

        $ milla authordeps --missing | cpanm
        $ milla listdeps --missing | cpanm

    Check you code coverage.

        $ milla cover

    Several ways to run the test.

        $ milla test
        $ milla test --author --release
        $ AUTHOR_TESTING=1 RELEASE_TESTING=1 milla test
        $ AUTHOR_TESTING=1 RELEASE_TESTING=1 milla run prove t/01_instantiation.t
        $ LOGGING=1 milla run prove t/t/02_request.t

    Release the module.

        $ milla build
        $ milla release

METHODS

 new($api_key, $api_secret, [%$args])

    Construct a new WebService::Mocean instance. The api_key and api_secret
    is compulsory fields. Optionally takes additional hash or hash
    reference.

        # Instantiate the class.
        my $mocean_api = WebService::Mocean->new(api_key => 'foo', api_secret => 'bar');
    
        # Alternative way.
        my $mocean_api = WebService::Mocean->new({api_key => 'foo', api_secret => 'bar'});

  api_url

    The URL of the API resource.

        # Instantiate the class by setting the URL of the API endpoints.
        my $mocean_api = WebService::Mocean->new({api_url => 'http://example.com/api/'});
    
        # Alternative way.
        my $mocean_api = WebService::Mocean->new(api_key => 'foo', api_secret => 'bar');
        $mocean_api->api_url('http://example.com/api/');

 send_sms($params)

    Send Mobile Terminated (MT) message, which means the message is sent
    from mobile SMS provider and terminated at the to the mobile phone.

        # Send sample SMS.
        my $response = $mocean_api->send_sms({
            'mocean-to' => '0123456789',
            'mocean-from' => 'ACME Ltd.',
            'mocean-text' => 'Hello'
        });

 send_verification_code($params)

    Send a random code for verification to a mobile number.

        my $response = $mocean_api->send_verification_code({
            'mocean-to' => '0123456789',
            'mocean-brand' => 'ACME Ltd.',
        });

 check_verification_code($params)

    Check the verfication code received from your user.

        my $response = $mocean_api->check_verification_code({
            'mocean-reqid' => '395935',
            'mocean-code' => '234839',
        });

 get_account_balance()

    Get your Mocean account balance.

        my $response = $mocean_api->get_account_balance();

 get_account_pricing()

    Get your Mocean account pricing and supported destination.

        my $response = $mocean_api->get_account_pricing();

 get_message_status()

    Get the outbound SMS current status.

        my $response = $mocean_api->get_message_status({
            'mocean-msgid' => 123456
        });

COPYRIGHT AND LICENSE

    This software is Copyright (c) 2018 by Kian Meng, Ang.

    This is free software, licensed under:

        The Artistic License 2.0 (GPL Compatible)

AUTHOR

    Kian Meng, Ang <kianmeng@users.noreply.github.com>