Download the PHP package axo3/api-client without Composer
On this page you can find all versions of the php package axo3/api-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download axo3/api-client
More information about axo3/api-client
Files in axo3/api-client
Package api-client
Short Description PHP client for the axo3 real-estate data API: fetch your stock as JSON, keep it as a local file snapshot, revalidate at the interval the API dictates. Framework-free.
License MIT
Homepage https://axo3.ch
Informations about the package api-client
axo3 API client
PHP client for the axo3 real-estate data API: fetch your stock as JSON, keep it as a local file snapshot, revalidate at the interval the API dictates. Framework-free — works in WordPress, Joomla, any CMS, or plain PHP.
You need an API key. Keys are issued per connection in the axo3 backend; the code here is free (MIT), the API access is part of your axo3 plan.
Install
With Composer:
Without Composer (WordPress, Joomla, plain PHP): download the release ZIP, unpack it anywhere in your project and load the bundled autoloader:
Requirements: PHP >= 8.2 with curl and json.
Use
Two rules the service enforces for you, and that you should not work around:
- Render first, ask afterwards.
units(),findUnit()andtree()read the local snapshot only.revalidateIfDue()belongs after the page is built or in a background job — never inside the render path. - The API dictates the pace. Every answer says when to ask again;
the service stores it and
revalidateIfDue()obeys it. No polling loops.
What the data looks like — fields, vocabulary, media links, ETag rules — is specified in docs/units-v1.md.
Failure behaviour
A failed fetch (network down, key revoked, API rebuilding) never breaks your
page: the current snapshot stays in place and keeps being served, the attempt
is logged to logFile, and the next attempt waits for the normal interval.
To raise your own alert, pass a callback:
$service->health() is a keyed liveness probe for a "check connection"
button in your own admin UI.
License
MIT — see LICENSE.
All versions of api-client with dependencies
ext-curl Version *
ext-json Version *