PHPackages wedesignit/hotelprofessionals-api-client - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. wedesignit/hotelprofessionals-api-client ActiveLibrary[API Development](/categories/api) wedesignit/hotelprofessionals-api-client ======================================== PHP Api wrapper for the Hotelprofessionals Api V1 v1.0.12(2y ago)024[1 PRs](https://github.com/WeDesignIt/hotelprofessionals-api-client/pulls)MITPHPPHP >=7.4 Since Apr 7Pushed 1y ago4 watchersCompare [ Source](https://github.com/WeDesignIt/hotelprofessionals-api-client)[ Packagist](https://packagist.org/packages/wedesignit/hotelprofessionals-api-client)[ RSS](/packages/wedesignit-hotelprofessionals-api-client/feed)WikiDiscussions master Synced today READMEChangelog (6)Dependencies (2)Versions (17)Used By (0) Hotelprofessionals PHP API Client ================================= [](#hotelprofessionals-php-api-client) Requirements ------------ [](#requirements) PHP 7.4 or higher. Installation ------------ [](#installation) ``` compose require wedesignit/hotelprofessionals-api-client ``` Usage ----- [](#usage) ``` use WeDesignIt\HotelprofessionalsApiClient\Client; use WeDesignIt\HotelprofessionalsApiClient\Hotelprofessionals; // Can be obtained through HP. $apiKey = "2|xyzthisapikeywontwork"; // Establish the connection. $client = Client::init($apiKey); $hp = Hotelprofessionals::init($client); // Quick check if everything is properly setup. $hp->authenticate(); ``` ### Extra options [](#extra-options) #### Custom URL [](#custom-url) In case you want to use a custom URL (e.g. to target a testing environment), you can pass the base URL for the API as second parameter to the client: ``` $client = Client::init($apiKey, 'https://integratie.hotelprofessionals.nl/api/v1/') ``` Caution It is important to end the base URL with a forward slash (`/`), otherwise you may receive weird results. #### Properties [](#properties) As third parameter, you can pass an `array` with properties. The benefit of using an `array` is that it can be infinitely expanded while remaining backwards compatible. It also keeps the `__constructor` from becoming bloated. ##### *Basic auth* [](#basic-auth) Sometimes a website might use basic auth. Simply add `basicAuth` to the `$properties` array: ``` $client = Client::init($apiKey, 'https://integratie.hotelprofessionals.nl/api/v1/', [ 'basicAuth' => 'yourBasicAuthSecret', ]) ``` If you're curious about how this works, you can [read more about it here](https://github.com/nickstenning/nginx-multiauth). ##### *Debug mode* [](#debug-mode) If you're curious about the calls made, you can enable debug mode. On each request, it will perform the following code: ``` var_dump(urldecode($request->getRequestTarget())) ``` Simply set `debugMode` to `true` in the `$properties` array. ``` $client = Client::init($apiKey, 'https://integratie.hotelprofessionals.nl/api/v1/', [ 'debugMode' => true, ]) ``` ### Read the docs [](#read-the-docs) We highly suggest you to read the official API docs, this will give you more information on what the API expects. This can be found at: . Resources --------- [](#resources) There's lots of resources available to fetch data from Hotelprofessionals directly. ### Department categories [](#department-categories) ``` // list all available department categories $hp->departmentCategory()->list(); // get a specific department category $hp->departmentCategory()->show(1449); ``` ### Departments [](#departments) ``` // list all available Departments $hp->department()->list(); // get a specific department $hp->department()->show(56); ``` ### Occupation [](#occupation) ``` // list all available occupations $hp->occupation()->list(); // get a specific occupation $hp->occupation()->show(739); ``` ### Experiences [](#experiences) ``` // list all available experiences $hp->experience()->list(); // get a specific experiences $hp->experience()->show(1449); ``` ### Languages [](#languages) ``` // list all available languages $hp->language()->list(); // get a specific languages $hp->language()->show(1449); ``` ### Educations [](#educations) ``` // list all available education $hp->education()->list(); // get a specific education $hp->education()->show(1449); ``` ### Employment types [](#employment-types) ``` // list all available employment types $hp->employmentType()->list(); // get a specific employment type $hp->employmentType()->show(1449); ``` ### Function features [](#function-features) ``` // list all available function features $hp->functionFeature()->list(); // get a specific function feature $hp->functionFeature()->show(1449); ``` ### Countries [](#countries) ``` // list all available countries $hp->country()->list(); // get a specific country $hp->country()->show(149); ``` ### Employers [](#employers) Note: only a parent account (which can have sub accounts) can access this endpoint. This endpoint lists all sub accounts for the employer associated with the used API key. ``` // list all available Employers $hp->employer()->list(); // get a specific Employer $hp->employer()->show(432); ``` ### JobListings [](#joblistings) ``` // list all job listings (including for sub account(s) if current account is a parent) $hp->jobListing()->list(); // get a specific job listing $jobListingResource = $hp->jobListing()->show(10552); // store a job listing (see documentation for full structure) $attributes = [ 'job_listings' => [ 'title' => [ 'nl' => 'Nieuwe vacature', 'en' => 'New job listing', ] ], ]; $newJobListingResource = $hp->jobListing()->store($attributes); $newId = $newJobListingResource['data']['id']; // update a job listing $attributes['title']['en'] = 'New job listing title, in the English locale'; $updatedJobListingResource = $hp->jobListing()->update($newId, $attributes); // publish a job listing (if not already published) $hp->jobListing()->publish(10552); // delete a job listing (generally not recommended) $hp->jobListing()->delete($newId); ``` ### Pagination [](#pagination) Every list method will return a paginated response, the page can be changed by using the `page` method: ``` // return page 3 of the department list. $hp->department()->page(3)->list(); ``` ### Filtering [](#filtering) Some endpoints support filtering. Be sure to read the documentation to know which endpoints support which filters. The documentation will also state which column(s) and which delimiter(s) are supported. Note that if a delimiter isn't supported, the default will be used. The structure for filters is as follows: ``` // Main array holds sub-arrays: $filters = [ [ // The column to filter on. Required. 'column' => $columnToFilter, // The value to apply. Required. 'value' => $valueToFilter, // The delimiter for filtering. Optional, defaults to '='. 'delimiter' => '=', ], ]; ``` Filters can be applied like so: ``` $filters = [ [ 'column' => 'status', 'value' => 'published', 'delimiter' => '=', ], ]; $hp->jobListing()->filter($filters)->list(); ``` Note that duplicate filters *will* be processed and might caught unexpected results. ### Health Score 29 — LowBetter than 57% of packages Maintenance35 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community11 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 83.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~62 days Recently: every ~28 days Total 14 Last Release 736d ago PHP version history (2 changes)v1.0.0PHP ^7.4 v1.0.2PHP >=7.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/9ae5357d893c402ae052f7e1705f6071de01dfa303800e6f9ba3ef27188fbea8?d=identicon)[pvankouteren](/maintainers/pvankouteren) --- Top Contributors [![frogeyedman](https://avatars.githubusercontent.com/u/26088905?v=4)](https://github.com/frogeyedman "frogeyedman (40 commits)")[![Yinci](https://avatars.githubusercontent.com/u/53834992?v=4)](https://github.com/Yinci "Yinci (8 commits)") --- Tags Hotelprofessionalsapi wrapper Hotelprofessionalsphp client Hotelprofessionals ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/wedesignit-hotelprofessionals-api-client/health.svg) ``` [![Health](https://phpackages.com/badges/wedesignit-hotelprofessionals-api-client/health.svg)](https://phpackages.com/packages/wedesignit-hotelprofessionals-api-client) ``` ### Alternatives [statamic/cms The Statamic CMS Core Package 4.8k3.6M981](/packages/statamic-cms)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[neuron-core/neuron-ai The PHP Agentic Framework. 2.0k656.1k38](/packages/neuron-core-neuron-ai)[avalara/avataxclient Client library for Avalara's AvaTax suite of business tax calculation and processing services. Uses the REST v2 API. 528.5M7](/packages/avalara-avataxclient)[files.com/files-php-sdk Files.com PHP SDK 2481.1k](/packages/filescom-files-php-sdk)[aimeos/prisma A powerful PHP package for integrating media related Large Language Models (LLMs) into your applications 1943.1k5](/packages/aimeos-prisma) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)