net3000.hotelbeds 1.0.0

Net3000.Hotelbeds

Overview

The Net3000.Hotelbeds library provides integration with the Hotelbeds APItude APIs for Net3000 solutions. Hotelbeds is a hotel bed bank; this library covers hotel availability search, rate revalidation, booking management, and static hotel content.

Features

• Availability Search: Search hotel availability by hotel codes, destination code, or geolocation
• Check Rates: Revalidate rate keys before booking (required for RECHECK rate types)
• Bookings: Create, retrieve, list, and cancel bookings (including cancellation-fee simulation)
• Hotel Content: Static hotel content (names, descriptions, images, facilities) with incremental sync support
• Response Models: Typed request/response models for the above endpoints

Installation

dotnet add package net3000.hotelbeds

Configuration

Add the Hotelbeds credentials to your configuration (values are supplied via NET3000_ environment variables — never commit real keys):

{
  "Hotelbeds": {
    "ApiKey": "",
    "Secret": ""
  }
}

Usage

using Net3000.Hotelbeds;
using Net3000.Hotelbeds.Models;

var service = new HotelbedsService
{
    ApiKey = configuration["Hotelbeds:ApiKey"],
    Secret = configuration["Hotelbeds:Secret"],
    BaseUrl = "https://api.test.hotelbeds.com" // live: https://api.hotelbeds.com
};

// Verify connectivity + credentials
var status = await service.StatusAsync();

// Search availability
var availability = await service.AvailabilityAsync(new AvailabilityRequest
{
    stay = new Stay { checkIn = "2026-09-15", checkOut = "2026-09-18" },
    occupancies = new List<Occupancy> { new() { rooms = 1, adults = 2, children = 0 } },
    destination = new Destination { code = "PMI" }
});

// Book a returned rate
var booking = await service.CreateBookingAsync(new BookingRequest
{
    holder = new Holder { name = "First", surname = "Last" },
    rooms = new List<BookingRoom> { new() { rateKey = "<rateKey from availability/checkrates>" } },
    clientReference = "NET3000-12345"
});

Authentication

Hotelbeds authenticates every request with two headers, handled automatically by the service:

• Api-key: the account API key
• X-Signature: lowercase hex SHA-256 of apiKey + secret + unixTimestampSeconds

Signatures are time-sensitive — the server clock must be reasonably accurate.

Environments

• Test: https://api.test.hotelbeds.com (default)
• Live: https://api.hotelbeds.com