# Discount Network

[![Build
Status](https://travis-ci.org/discountnetwork/discountnetwork-ruby.svg?branch=master)](https://travis-ci.org/discountnetwork/discountnetwork-ruby)
[![Code
Climate](https://codeclimate.com/github/discountnetwork/discountnetwork-ruby/badges/gpa.svg)](https://codeclimate.com/github/discountnetwork/discountnetwork-ruby)
[![Gem
Version](https://badge.fury.io/rb/discountnetwork.svg)](https://badge.fury.io/rb/discountnetwork)

Ruby API client for Discount Network API

## Installation

Add this line to your application's Gemfile:

```ruby
gem "discountnetwork", "~> 0.1.1"
```

And then execute:

```sh
$ bundle
```

## Configure

Once you have your API keys from Discount Network, then you can add an initializer
to set up your API keys

```ruby
DiscountNetwork.configure do |config|
  config.api_key = "YOUR_API_KEY"

  # Default configurations
  # config.api_host = "https://api.discountnetwork.io/v1"
end
```

## Usages

### Session

Session API allow you to authenticate a subscriber, create a new session or
destroying an existing session.

#### Create a new session

Creating a new session will verify the subscriber and return the `subscriber`
object with subscription details.

```ruby
DiscountNetwork::Session.create(
  name: "username", password: "secret_password"
)
```

### Account

#### Find user account

To retrieve the user account details using the Discount Network `account` API

```ruby
#
# The `auth_token` is optional, if you don't pass any
# parameter then it will try to retrieve the subscriber
# using the `auth_token` configuration.
#

DiscountNetwork::Account.find(auth_token)
```

#### Create a user account

To create a new user account you can use the `Account.create` interface, but one
important things to remember that account creation is not available for all white
label, so if it's failing then most likely this feature is not supported on your
white label.

```ruby
DiscountNetwork::Account.create(subscriber_attributes)
```

#### Update user account

Once the user is logged in and `auth_token` has been configured properly then
we can update the user details using the DiscountNetwork `account` API

```ruby
DiscountNetwork::Account.update(subscriber_attributes)
```

### Activation

#### Find a subscriber

The `activation` offers an easier way to find the subscriber details based on
the `activation_token`. To find a `subscriber` use

```ruby
DiscountNetwork::Activation.find(activation_token)
```

#### Activate a subscriber

Once subscriber has provided their required information then we can activate
their account using the `Activation` API. The API already has validations in
place but it would be easier to implement some validation before sending any
activation API request.

```ruby
DiscountNetwork::Activation.activate(
  activation_token, subscriber_attributes
)
```

### Password

#### Forgot password

If the subscriber forgot their password then developer can allow them to reset
their password using the Discount network API.

```ruby
DiscountNetwork::Password.forgot(email_address)
```

#### Validate reset token

Before allowing subscriber to reset their password, developer can validate if
the reset token is valid or not as expired or invalid reset token won't allow
subscriber to reset their password.

```ruby
DiscountNetwork::Password.validate(reset_token)
```

#### Set new password

Once subscriber has submitted a valid reset request and followed the instruction
then we can allow them to set their password as follow

```ruby
DiscountNetwork::Password.create(reset_token, password_attributes)
```

### Supplementary

Each Discount Network subscription comes with varies number of supplementary
subscribers, that means primary member can add one or more of this friends or
family member to his subscription. The supplementary API provides an easier
way to manage the supplementary subscribers. Please note, This interface expects
that the subscriber has already been authenticated before making any API call.

#### List supplementaries

To list all the supplementary subscribers for the authenticated subscriber
developer can use the `list` interface for supplementary.

```ruby
DiscountNetwork::Supplementary.list
```

#### Add supplementary

To add a new supplementary subscriber with authenticated subscriber's
subscription developer can use the `create` interface for supplementary.

```ruby
DiscountNetwork::Supplementary.create(
  subscriber_attributes
)

# subscriber attributes
subscriber_attributes = {
  first_name: "John",
  last_name: "Green",
  phone: "+1 123 345 5678",
  email: "john.green@example.com"
}
```

### Destination

#### List destinations

Retrieve the list of destinations based on a search term. This is useful when
you are planning to show the list of destinations while user start to type
destination name

```ruby
DiscountNetwork::Destination.list(term: "bangkok")
```

### Search

#### Create new search

You can create a new search using the API. Please note: It's advisable to wait
10-15 seconds before trying to retrieve the search results.

```ruby
DiscountNetwork::Search.create(
  adults: 2,
  children: 0,
  room_numbers: 1
  location_id: 835,
  check_in: "25/10/2016",
  check_out: "28/10/2016",
  location_name: "Bangkok, Thailand",
)
```

#### Retrieve search details

Once, you have created a new search and you have the search id then you can
retrieve the search details as

```ruby
DiscountNetwork::Search.find(search_id)
```

### Result

#### Retrieve search results

Retrieve the hotel search results from the Discount Network API.

```ruby
DiscountNetwork::Result.where(
  search_id: search_id
)
```

#### Retrieve a hotel details

Retrieve the hotel details for a specific search

```ruby
DiscountNetwork::Result.find_by(
  search_id: search_id, hotel_id: hotel_id
)
```

### Booking

#### Creating a new booking

Submit a new booking request for a specific hotel using the API.

```ruby
# Creating a new booking request for a specific hotel, Pay close
# attention to the construction of the booking object
#
# If you want to add multiple travellers in one booking then
# pass an Array for travellers as
# `travellers: [traveller_one_attributes, traveller_two_attributes]`
#
# If you need to add multiple properties in one request, like one
# hotel and a condo in one booking request, then pass an Array as
#`properties: [property_one_attributes, property_two_attributes]`

DiscountNetwork::Booking.create(
  hotel_id: "hotel_id",
  search_id: "search_id",
  travellers: traveller_attributes,
  properties: property_attributes
)

# Traveller attributes

traveller_attributes = {
  first_name: "John",
  last_name: "Doe",
  phone: "012 345 6789",
  email: "john.doe@example.com",
  address: "123 Main Street",
  city: "New York",
  state: "New York",
  zip: "NY10310"
}

# Property attributes

property_attributes = {
  property_id: "property_101",
  provider_name: "Booking.com",
  name: "Nasa Vagas, Thailand",
  price: "100.99",
  description: "Description",
  review_score: "90",
  total_reviews: "10000",
  currency_code: "USD"
}
```

### Find a booking

To find the details for a specific booking request, including the confirmation
number, use

```ruby
DiscountNetwork::Booking.find(booking_id)
```

### Providers

Discount Network partnered with multiple vendors to provide the best possible
price in all sort of travel. This will allow developer to add those public
provider in their site and let their subscriber search and contact the support
to receive their subscriber discount.

#### Retrieving providers

This will allow developer to retrieve all of the specified public travel partner
so they can show them to their site. Note: They `type` is mandatory and
the supported value for `type` are `hotel`, `cruise`, `resort`, `tour`, `package`
and `car`.

```ruby
DiscountNetwork::Provider.where(type: "hotel")
```

### Find a provider

On the provider listing API, one of the most important `attribute` the API
returns is `slug`, we can use that `slug` to retrieve the details about any
specific provider.

```ruby
DiscountNetwork::Provider.find_by_slug(slug)
```

## Development

We are following Sandi Metz's Rules for this gem, you can read the
[description of the rules here]
(http://robots.thoughtbot.com/post/50655960596/sandi-metz-rules-for-developers). All new code should follow these rules. If you make changes in a pre-existing
file that violates these rules you should fix the violations as part of
your contribution.

### Setup

* Clone the repository.

```sh
git clone https://github.com/discountnetwork/discountnetwork-ruby.git
```

* Setup your environment.

```sh
bin/setup
```

* Run the test suite

```sh
bin/rake
```

### PlayBox

* Setup API keys.

```sh
cp .sample.pryrc .pryrc
vim .pryrc
```

* Start your console.

```sh
bin/console
```

* Start playing with it.

```sh
DiscountNetwork::Session.create(name: "username", password: "password")
```

## Testing

### RSpec

This gem provides an easier way to test Discount Network API Responses. Simply
include the following line in your `spec_helper` and you should have access to
all of the test helpers.

```ruby
require "discountnetwork/rspec"
```

## Contributing

First, thank you for contributing! We love pull requests from everyone. By
participating in this project, you hereby grant the right to grant or transfer
an unlimited number of non exclusive licenses or sub-licenses to third parties,
under the copyright covering the contribution to use the contribution by all
means.

Here are a few technical guidelines to follow:

1. Open an [issue][issues] to discuss a new feature.
1. Write tests to support your new feature.
1. Make sure the entire test suite passes locally and on CI.
1. Open a Pull Request.
1. [Squash your commits][squash] after receiving feedback.
1. Party!

[issues]: https://github.com/discountnetwork/discountnetwork-ruby/issues
[squash]: https://github.com/thoughtbot/guides/tree/master/protocol/git#write-a-feature

## License

The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).