README

此SDK用于连接hotelbook并使用其方法作为第三方API。

• 安装
• 入门
• API参考
• 联系我们

安装

composer require tmconsulting/hotelbook-php-sdk

入门

首先，您需要hotelbook的凭证。
凭证配置如下。

$config = [
    'url' => 'https://hotelbook.pro/xml',
    'login' => 'YOUR LOGIN',
    'password' => 'YOUR PASSSWORD'
];

（如果传入任何无效内容，则在创建主实例时抛出异常）

之后，包含库并创建其基本实例。

//Require vendor
require __DIR__ . "/../vendor/autoload.php";

//Use main hotelbook class
use App\Hotelbook\Main;

//Create an instance of main class 
$hotelbook = new Main($config);

现在您可以使用hotelbook SDK的所有方法。例如

例如，搜索酒店

use Carbon\Carbon;

$from = Carbon::parse('08-07-2018');
$till = Carbon::parse('09-07-2018');

$result = $hotelbook->search(1, $from, $till, [new SearchPassenger(1, [2])]);

现在结果将是一个包含所有结果的ResultProceeder实例

处理错误和进行结果。

如果方法有错误，它会抛出一个异常，您可以处理它并运行getErrors的结果。

try {
    $result = $main->book(...someArguments);    
} catch (Exception $e)
{
    //Do something with the exception
}

每个方法都返回一个对象（如果它没有抛出异常），该对象有两种方法

• getItems()
• getErrors()

getItems 方法返回方法返回的所有项目。 getErrors 方法返回hotelbook返回的所有错误。

因此，您可以进行如下操作

//$result is a result of search request

if (!empty($result->getErrors()) {
 //Handle error
} 

$items = $result->getItems();
//Do something with items.

API参考

元说明

所有静态数据API $methods都可通过$main->{$YOUR_METHOD_NAME}访问。
它返回一个包含结果（项目、错误）的对象。（如上所述。）

可用方法

要使用任何方法，您必须创建HotelBook SDK的实例。详情请参阅此处

当前可用方法

• 搜索（搜索酒店）
• 异步搜索（异步模式搜索酒店）
• 详情（酒店详情）
• 预订订单（预订酒店）
• 取消订单（取消预订）
• 确认订单（确认预订）
• 取消订单（确认后取消预订）

以及获取字典的方法。

• 国家 -（获取所有可用国家）
• 城市 -（获取所有可用城市）
• 位置 -（获取所有可用位置）
• 度假村 -（获取所有可用度假村）
• 酒店类型 -（获取所有可用酒店类型）
• 酒店类别 -（获取所有可用酒店类别）
• 酒店设施 -（获取所有可用酒店设施）
• 酒店列表 -（获取所有可用酒店列表）
• 餐饮 -（获取所有可用餐饮类型）
• 早餐餐饮 -（获取所有可用早餐餐饮类型）
• 房间大小 -（获取所有可用房间大小）
• 房间类型 -（获取所有可用房间类型）
• 房间设施 -（获取所有可用房间设施）
• 房间视角 -（获取所有可用房间视角）
• 货币汇率 -（获取货币汇率）

获取国家

元说明

获取国家方法用于获取hotelbook数据库中存在的所有国家。因此，您可以用作搜索参数等...

基本示例

//You already have an instance of SDK, and it's stored in $main
$countries = $main->country();
//Now, in countries, you have a simple result.
$countiesArray = $countries->getItems();
//Now in $countiesArray you have an array of Countries.

获取城市

元说明

获取城市用于使搜索更深入，因此您可以用作搜索参数。此外，您还可以按国家搜索城市（因此您获取一个国家的所有城市。）

基本示例

获取数据库中存在的所有城市。

$cities = $main->city();
$citiesArray = $cities->getItems();

按国家获取所有城市。

//Get first country item from the DB.
$country = current($main->country()->getItems());
//Find all cities there.
$cities = $main->city($country);
//Get all available items.
$citiesArray = $cities->getItems();

联系我们。

如果您对API或SDK本身有任何问题或疑问，请创建一个问题，或者您可以通过电子邮件向shatilo.reymond@gmail.com或roquie0@gmail.com发送电子邮件。