{"id":20610864,"url":"https://github.com/vmavromatis/hotel-api-sdk-python","last_synced_at":"2025-04-15T04:32:30.983Z","repository":{"id":45552548,"uuid":"108740394","full_name":"vmavromatis/hotel-api-sdk-python","owner":"vmavromatis","description":"Python SDK for the Hotelbeds API http://developer.hotelbeds.com (BETA)","archived":false,"fork":false,"pushed_at":"2017-12-10T22:35:29.000Z","size":113,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-28T16:03:23.661Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vmavromatis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-29T14:17:38.000Z","updated_at":"2023-10-02T22:12:41.000Z","dependencies_parsed_at":"2022-09-17T00:20:57.061Z","dependency_job_id":null,"html_url":"https://github.com/vmavromatis/hotel-api-sdk-python","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmavromatis%2Fhotel-api-sdk-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmavromatis%2Fhotel-api-sdk-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmavromatis%2Fhotel-api-sdk-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmavromatis%2Fhotel-api-sdk-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vmavromatis","download_url":"https://codeload.github.com/vmavromatis/hotel-api-sdk-python/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249006599,"owners_count":21197307,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T10:18:08.467Z","updated_at":"2025-04-15T04:32:30.965Z","avatar_url":"https://github.com/vmavromatis.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hotel-api-sdk-python\nBOOKINGAPI is designed to book hotels in real time as fast as in two steps. It covers the complete booking process; it allows generating lists of hotels, confirming bookings, getting lists of bookings, obtaining booking information, making cancellations and modify existing bookings.   BOOKINGAPI works in combination with CONTENTAPI to obtain content information from the hotels, such as pictures, description, facilities, services, etc. Please refer to the ContentAPI documentation and IO/DOCS for related information.    BOOKINGAPI has been designed for a two steps confirmation, but due the the complexity of client and providers systems a third method has been designed.\n\nThis Python package is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:\n\n- API version: 1.0\n- Package version: 1.0.0\n- For more information, please visit [https://developer.hotelbeds.com](https://developer.hotelbeds.com)\n\n## Requirements.\n\nPython 2.7 and 3.4+\n\n## Installation \u0026 Usage\n### pip install\n\nIf the python package is hosted on Github, you can install directly from Github\n\nFor python 2\n```sh\nsudo pip2.7 install git+https://github.com/vmavromatis/hotel-api-sdk-python.git --upgrade\n```\nFor python 3\n```sh\nsudo pip install git+https://github.com/vmavromatis/hotel-api-sdk-python.git --upgrade\n```\n\n(you may need to run `pip` with root permission: `sudo pip install git+https://github.com//.git`)\n\nThen import the package:\n```python\nimport bookingapi \n```\n\n## Getting Started\n\nPlease follow the [installation procedure](#installation--usage) and then run the following to make a status request:\n\n```python\nfrom __future__ import print_function\nimport time, hashlib\nimport bookingapi\nfrom bookingapi.rest import ApiException\nfrom pprint import pprint\n# create an instance of the API class\napi_instance = bookingapi.StatusApi()\nversion = '1.0'  # str | Default version for this operation\n\n# Your API Key and secret\napiKey = \"xxxxxxxxxxxxxxxxxxxxxxx\"\nSecret = \"xxxxxxxxxx\"\n\n# Signature is generated by SHA256 (Api-Key + Secret + Timestamp (in seconds))\nsigStr = \"%s%s%d\" % (apiKey, Secret, int(time.time()))\nsignature = hashlib.sha256(sigStr).hexdigest()\n\n\napi_instance.api_client.set_default_header('api-key', apiKey)\napi_instance.api_client.set_default_header('x-signature', signature)\n\n\ntry:\n    # Status check\n    api_response = api_instance.status(version)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling StatusApi-\u003estatus: %s\\n\" % e)\n\n\n```\n## Workflow\n\n[Refer to the wiki page for a basic workfow](https://github.com/vmavromatis/hotel-api-sdk-python/wiki)\n\n\n## Documentation for API Endpoints\n\nAll URIs are relative to *https://api.test.hotelbeds.com/hotel-api*\n\nClass | Method | HTTP request | Description\n------------ | ------------- | ------------- | -------------\n*BookingsApi* | [**booking**](docs/BookingsApi.md#booking) | **POST** /{version}/bookings | Booking confirm\n*BookingsApi* | [**booking_cancellation**](docs/BookingsApi.md#booking_cancellation) | **DELETE** /{version}/bookings/{bookingId} | Booking cancellation\n*BookingsApi* | [**booking_change**](docs/BookingsApi.md#booking_change) | **PUT** /{version}/bookings/{bookingId} | Booking change\n*BookingsApi* | [**booking_detail**](docs/BookingsApi.md#booking_detail) | **GET** /{version}/bookings/{bookingId} | Booking detail\n*CheckratesApi* | [**check_rate**](docs/CheckratesApi.md#check_rate) | **POST** /{version}/checkrates | Check Availability Rates\n*HotelsApi* | [**availability**](docs/HotelsApi.md#availability) | **POST** /{version}/hotels | Hotel availability\n*StatusApi* | [**status**](docs/StatusApi.md#status) | **GET** /{version}/status | Check API status\n\n\n## Documentation For Models\n\n - [ApiAuditData](docs/ApiAuditData.md)\n - [ApiBillingAddress](docs/ApiBillingAddress.md)\n - [ApiBoards](docs/ApiBoards.md)\n - [ApiBooking](docs/ApiBooking.md)\n - [ApiBookingDevice](docs/ApiBookingDevice.md)\n - [ApiBookingRoom](docs/ApiBookingRoom.md)\n - [ApiBookings](docs/ApiBookings.md)\n - [ApiCancellationPolicy](docs/ApiCancellationPolicy.md)\n - [ApiCost](docs/ApiCost.md)\n - [ApiCreditCard](docs/ApiCreditCard.md)\n - [ApiDailyRate](docs/ApiDailyRate.md)\n - [ApiDestination](docs/ApiDestination.md)\n - [ApiError](docs/ApiError.md)\n - [ApiFilter](docs/ApiFilter.md)\n - [ApiGeoLocation](docs/ApiGeoLocation.md)\n - [ApiHolder](docs/ApiHolder.md)\n - [ApiHotel](docs/ApiHotel.md)\n - [ApiHotels](docs/ApiHotels.md)\n - [ApiHotelsFilter](docs/ApiHotelsFilter.md)\n - [ApiKeyword](docs/ApiKeyword.md)\n - [ApiKeywordsFilter](docs/ApiKeywordsFilter.md)\n - [ApiModificationPolicies](docs/ApiModificationPolicies.md)\n - [ApiOccupancy](docs/ApiOccupancy.md)\n - [ApiOffer](docs/ApiOffer.md)\n - [ApiPax](docs/ApiPax.md)\n - [ApiPaymentCard](docs/ApiPaymentCard.md)\n - [ApiPaymentContactData](docs/ApiPaymentContactData.md)\n - [ApiPaymentData](docs/ApiPaymentData.md)\n - [ApiPromotion](docs/ApiPromotion.md)\n - [ApiRate](docs/ApiRate.md)\n - [ApiRateBreakDown](docs/ApiRateBreakDown.md)\n - [ApiRateDiscount](docs/ApiRateDiscount.md)\n - [ApiRateSupplement](docs/ApiRateSupplement.md)\n - [ApiReview](docs/ApiReview.md)\n - [ApiReviewFilter](docs/ApiReviewFilter.md)\n - [ApiRooms](docs/ApiRooms.md)\n - [ApiShiftRate](docs/ApiShiftRate.md)\n - [ApiSource](docs/ApiSource.md)\n - [ApiStay](docs/ApiStay.md)\n - [ApiSupplier](docs/ApiSupplier.md)\n - [ApiTax](docs/ApiTax.md)\n - [ApiTaxes](docs/ApiTaxes.md)\n - [ApiUpselling](docs/ApiUpselling.md)\n - [ApiVoucher](docs/ApiVoucher.md)\n - [ApiVoucherComment](docs/ApiVoucherComment.md)\n - [ApiVoucherEmail](docs/ApiVoucherEmail.md)\n - [AvailabilityRQ](docs/AvailabilityRQ.md)\n - [AvailabilityRS](docs/AvailabilityRS.md)\n - [BookingCancellationRS](docs/BookingCancellationRS.md)\n - [BookingChangeRQ](docs/BookingChangeRQ.md)\n - [BookingChangeRS](docs/BookingChangeRS.md)\n - [BookingDetailRS](docs/BookingDetailRS.md)\n - [BookingListRS](docs/BookingListRS.md)\n - [BookingRQ](docs/BookingRQ.md)\n - [BookingRS](docs/BookingRS.md)\n - [CheckRateRQ](docs/CheckRateRQ.md)\n - [CheckRateRS](docs/CheckRateRS.md)\n - [Room](docs/Room.md)\n - [StatusRS](docs/StatusRS.md)\n\n\n## Documentation For Authorization\n\n```python\n# Your API Key and secret\napiKey = \"xxxxxxxxxxxxxxxxxxxxxxx\"\nSecret = \"xxxxxxxxxx\"\n\n# Signature is generated by SHA256 (Api-Key + Secret + Timestamp (in seconds))\nsigStr = \"%s%s%d\" % (apiKey, Secret, int(time.time()))\nsignature = hashlib.sha256(sigStr).hexdigest()\n\napi_instance.api_client.set_default_header('api-key', apiKey)\napi_instance.api_client.set_default_header('x-signature', signature)\n```\nMore info at https://developer.hotelbeds.com/docs/read/Home#authentication\n\n## Author\n\ndeveloper@hotelbeds.com\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvmavromatis%2Fhotel-api-sdk-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvmavromatis%2Fhotel-api-sdk-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvmavromatis%2Fhotel-api-sdk-python/lists"}