Download the PHP package nglasl/silverstripe-apiwesome without Composer
On this page you can find all versions of the php package nglasl/silverstripe-apiwesome. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nglasl/silverstripe-apiwesome
More information about nglasl/silverstripe-apiwesome
Files in nglasl/silverstripe-apiwesome
Package silverstripe-apiwesome
Short Description A module for SilverStripe which will automatically create customisable JSON/XML feeds for your data objects (including pages), and provides a modular security token that can be used for other applications.
License BSD-3-Clause
Homepage https://github.com/nglasl/silverstripe-apiwesome
Informations about the package silverstripe-apiwesome
apiwesome
The current release is 2.2.15
A module for SilverStripe which will automatically create customisable JSON/XML feeds for your data objects (including pages), and provides a modular security token that can be used for other applications.
Requirement
- SilverStripe 3.0 → 3.5
This module is no longer supported.
Getting Started
- Place the module under your root project directory.
- Define any custom JSON/XML data object exclusions/inclusions through project configuration.
/dev/build
- Select
JSON/XML
through the CMS. - Configure attribute visibility.
Regenerate
the security tokenx:y
/apiwesome/retrieve/data-object-name/json?token=x:y
/apiwesome/retrieve/data-object-name/xml?token=x:y
Overview
Data Object Exclusions/Inclusions
ALL data objects are included by default (excluding some core), unless disabled or inclusions have explicitly been defined.
To completely disable the JSON/XML:
Attribute Visibility Customisation
The JSON/XML feed will only be available to data objects with attribute visibility set through the CMS. Any has_one
relationships may be displayed, where attribute visibility is determined recursively.
Recursive Relationships
These are enabled by default, however will greatly impact performance if many nested relationships are visible.
To disable the recursion:
Security Token
A JSON/XML feed request will require the current security token passed through, where this may be regenerated by an administrator (invalidating the previous security token).
The security token generation (and validation) is modular, and can still be used when the JSON/XML is completely disabled (more below):
Output
A JSON/XML feed request may have a number of optional filters applied, where the &filter
will only apply to visible attributes:
&limit=5
&sort=Attribute,ORDER
&filter1=value
&filter2=value
It may also be previewed through the appropriate model admin of your data object.
Pretty JSON
This is enabled by default, however will slightly impact performance if many nested relationships are visible.
To disable the pretty printing:
Developer Functionality
PHP
Accessing the service:
The methods available may be programmatically called to generate JSON, with optional filters:
XML, with optional filters:
JSON/XML for a versioned page (though the CMS may not correctly preview XML), with regard to the respective stage in index()
:
They may also be used to parse JSON/XML from another APIwesome instance. Therefore, this module may be used as both an API and external connector between multiple projects.
The security token validation (and generation) is modular, and can be used for other applications (more above):
jQuery
JSON example:
Maintainer Contact
Nathan Glasl, [email protected]