Download the PHP package 3scale/3scale_ws_api_for_php without Composer
On this page you can find all versions of the php package 3scale/3scale_ws_api_for_php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download 3scale/3scale_ws_api_for_php
More information about 3scale/3scale_ws_api_for_php
Files in 3scale/3scale_ws_api_for_php
Package 3scale_ws_api_for_php
Short Description Client for 3scale web service management system API
License MIT
Homepage https://support.3scale.net/libraries
Informations about the package 3scale_ws_api_for_php
Client for 3scale Web Service Management API 
3scale integration plugin for PHP applications. 3scale is an API Infrastructure service which handles API Keys, Rate Limiting, Analytics, Billing Payments and Developer Management. Includes a configurable API dashboard and developer portal CMS. More product stuff at http://www.3scale.net/, support information at http://support.3scale.net/.
Tutorials
- Plugin Setup: https://support.3scale.net/docs/deployment-options/plugin-setup
- Rate Limiting: https://support.3scale.net/docs/access-control/rate-limits
- Analytics Setup: https://support.3scale.net/quickstarts/3scale-api-analytics
Installation
Download the source code from github: http://github.com/3scale/3scale_ws_api_for_php and place it somewhere accessible from your project.
Usage
Require the ThreeScaleClient.php file (assuming you placed the library somewhere within the include path):
Then create an instance of the client
NOTE: unless you specify you will be expected to specify a
provider_key
parameter, which is deprecated in favor of Service Tokens:
Because the object is stateless, you can create just one and store it globally.
Then you can perform calls in the client:
NOTE:service_id
is mandatory since November 2016, both when using service tokens and when using provider keys
Authorize
To authorize a particular application, call the authorize
method passing it the
application id
and service id
and optionally the application key:
If you had configured a (deprecated) provider key, you would instead use:
Then call the isSuccess()
method on the returned object to see if the authorization was
successful:
If both provider and app id are valid, the response object contains additional information about the status of the application:
If the plan has defined usage limits, the response contains details about the usage broken down by the metrics and usage limit periods.
If the authorization failed, the getErrorCode()
returns system error code and getErrorMessage()
human readable error description:
Authrep
To authorize a particular application, call the authrep
method passing it the
application id
and service id
and optionally the application key:
Then call the isSuccess()
method on the returned object to see if the authorization was
successful:
If both provider and app id are valid, the response object contains additional information about the status of the application:
You can also use other patterns such as user_key
mode during the authrep call
Report
To report usage, use the report
method. You can report multiple transaction at the same time:
The "app_id"
, "usage"
parameters are required alongiwth service id
and service token
. Additionaly, you can specify a timestamp
of the transaction:
The timestamp can be either an unix timestamp (as integer) or a string. The string has to be in a format parseable by the strtotime function. For example:
If the timestamp is not in UTC, you have to specify a time offset. That's the "+0200" (two hours ahead of the Universal Coordinate Time) in the example above.
Then call the isSuccess()
method on the returned response object to see if the report was
successful:
In case of error, the getErrorCode()
returns system error code and getErrorMessage()
human readable error description:
Custom backend for the 3scale Service Management API
The default URI used for the 3scale Service Management API is http://su1.3scale.net:80. This value can be changed, which is useful when the plugin is used together with the on-premise version of the Red Hat 3scale API Management Platform.
In order to override the URL, pass the custom URI
while creating instance an instance of the client
Plugin integration
If you are interested in integrating the plugin with:
-
Composer check the packagist. This is kindly maintained by daws.ca tech team.
- Symphony2 check tonivdv's 3scaleBundle. This is kindly maintained by Adlogix tech team.
To Test
To run tests: php test/all.php
Legal
Copyright (c) 2010 3scale networks S.L., released under the MIT license.