Download the PHP package nocksapp/nocks-sdk-php without Composer
On this page you can find all versions of the php package nocksapp/nocks-sdk-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nocksapp/nocks-sdk-php
More information about nocksapp/nocks-sdk-php
Files in nocksapp/nocks-sdk-php
Package nocks-sdk-php
Short Description PHP SDK for the Nocks API
License MIT
Homepage https://nocks.com/
Informations about the package nocks-sdk-php
Nocks SDK PHP
Nocks SDK PHP is a php
package for Nocks. It can be used in any php >=5.4.0
environment. The SDK
supports both the calls to the Nocks api
endpoints as well to the oauth
endpoints.
- Installation
- Getting started
- Examples
- Support
Installation
This SDK uses composer.
Composer is a tool for dependency management in PHP. It allows you to declare the libraries your project depends on and it will manage (install/update) them for you.
For more information on how to use/install composer, please visit: https://github.com/composer/composer
To install this SDK into your project with composer, simply use:
$ composer require nocksapp/nocks-sdk-php
Getting Started
Oauth
The NocksOauth
class provides the following methods:
- getOauthUri
- requestToken
- refreshToken
- passwordGrantToken
- scopes
- tokenScopes
Example
Please checkout the oauth docs and examples to see how the oauth
methods can be used.
API
The NocksApi
class provides all the Nocks
resources. Please checkout the resources docs and examples.
Results
The result returned from a method call in the SDK will differ, please check the PHPDocs
to see what will be returned from a method. Most of the time it will be a Model
or a NocksResponse
.
Model
A Model
is just a simple object
which holds the data
returned from the api. Each Model
will provide the necessary getters
and setters
for the specific data
.
NocksResponse
A NocksResponse
is an object which holds a data array
and a pagination object
. This is typically returned from a .find
method.
Example:
Exceptions
The SDK uses the following exceptions. All exceptions are inherit from Nocks\SDK\Exception\Exception
.
- Nocks\SDK\Exception\Exception (super)
- Nocks\SDK\Exception\HttpException (super)
- Nocks\SDK\Exception\BadRequestException
- Nocks\SDK\Exception\ForbiddenException
- Nocks\SDK\Exception\GoneException
- Nocks\SDK\Exception\InternalServerError
- Nocks\SDK\Exception\MethodNotAllowedException
- Nocks\SDK\Exception\NotAcceptable
- Nocks\SDK\Exception\NotFoundException
- Nocks\SDK\Exception\ServiceUnavailable
- Nocks\SDK\Exception\TooManyRequests
- Nocks\SDK\Exception\UnauthorizedException
- Nocks\SDK\Exception\ValidationException
- Nocks\SDK\Exception\ScopeConfigurationException
- Nocks\SDK\Exception\HttpException (super)
HttpException
A HttpException
is thrown when a http call to Nocks
fails. The HttpException is the super
exception and the actual exception that is thrown is corresponding to the http statuscode
, see the documentation.
ValidationException
A ValidationException
may occur when you call a function with invalid
parameters or when there are missing
required parameters. For example:
Note that the SDK doesn't check your request data, if there is something wrong with your data, the http call will resolve in a HttpException
ScopeConfigurationException
A ScopeConfigurationException
may occur when calling a function which depends on a certain scope parameter that was not provided. For example, calling a private
resource while there was no accessToken
configured:
Examples
In the examples directory you will find examples for each call that is supported in this SDK.
Support
Need help or support? Please check https://www.nocks.com/support.
Found a bug? Please check the existing GitHub issues and open a new issue if necessary. Or even better, create a pull request to directly resolve the issue you have found!
All versions of nocks-sdk-php with dependencies
ext-curl Version *
ext-json Version *
ext-mbstring Version *