Download the PHP package evilfreelancer/resova-api-php without Composer
On this page you can find all versions of the php package evilfreelancer/resova-api-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download evilfreelancer/resova-api-php
More information about evilfreelancer/resova-api-php
Files in evilfreelancer/resova-api-php
Package resova-api-php
Short Description Resova API PHP7 client
License MIT
Homepage https://developers.resova.com/
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package resova-api-php
Resova API PHP7 client
This project is a simple and minimalistic client for work with Resova API, based on Guzzle Http client.
composer require evilfreelancer/resova-api-phpLaravel framework support
Resova API client is optimized for usage as normal Laravel package, all functional is available via \ResovaApi facade,
for access to client object you need instead:
Use:
You also may provide additional parameters to your client by passing array of parameters to getClient method:
Laravel installation
Install the package via Composer:
composer require evilfreelancer/resova-api-phpBy default the package will automatically register its service provider, but
if you are a happy owner of Laravel version less than 5.3, then in a project, which is using your package
(after composer require is done, of course), add intoproviders block of your config/app.php:
Optionally, publish the configuration file if you want to change any defaults:
php artisan vendor:publish --provider="Resova\\Laravel\\ClientServiceProvider"Terminology
There are four key objects in Resova that every API developer should know about.
| Objects | Description |
|---|---|
| items | An activity/service is known as an Item, these are what your customers will purchase. |
| instances | An instance is a date and time belonging to an item. An instance is required to be included when creating a booking. |
| bookings | A customer will make a booking for a specific Item and Instance (date/time), they're essentially purchasing something. All bookings belong to a Transaction |
| transactions | A Transaction is the overall purchase order. All Bookings belong to a Transaction and there can be more than one Booking per Transaction. |
How to use
See other examples of usage here separated by class names.
Basic example
Where can I find my api key?
If you haven't already, you can sign up for a new account here. Once you have logged into your account head over to Settings > General Settings > Developer where your API KEY will be located.
*Items* endpoints
Items mean your rooms in Resova system. https://developers.resova.com/reference#items*Availability* endpoints
Availability details of instances, instances prices and calendars of dates etc. > Instance - in logic of Resova API mean time slot with price https://developers.resova.com/reference#availability*Baskets* endpoints
Baskets in Resova it mean Carts, it contain details about prepared for booking carts created by clients. https://developers.resova.com/reference#the-basket-object*Customers* endpoints
For work with customers information, like emails, phones, addresses, etc. https://developers.resova.com/reference#customers*Gift Voucher* endpoints
Gift Vouchers in Resova it mean Promocodes, you can manage your promo campaigns. https://developers.resova.com/reference#gift-vouchers*Webhooks* endpoints
Some things which you also should know
-
Resova's technical support is very reluctant to answer any of your requests, even if you have a bank card connected and you earn money, with a small degree of probability any requests from you will stop being processed, and your mail will be blacklisted
-
On trial account you can't use API, so you can't check functionality before adding the bank card
-
You should add your server's IP to whitelist in Resova developer settings
-
But despite paragraph
3.your server's IP may be blocked automatically without explanations (via probably fail2ban), and support team after few unanswered questions will add your email/facebook account to blacklist -
Optimal amount of HTTP requests before your IP will banned is no more than 1000 per day, or about 40 requests per hour, maybe this is due to the recent DDoS attack to their servers, so be very careful, otherwise you will have to configure intermediate proxy servers, which is not very convenient (and which also will be banned after some time)
- Resova does not provide test accounts or stagging environments to test the functionality of your application before publishing to production, so be very careful when working with Resova API, double-check all data
