Download the PHP package breakpoint/etsy-php without Composer
On this page you can find all versions of the php package breakpoint/etsy-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package etsy-php
Etsy PHP API Wrapper
This library aims to provide an easy way to access all methods of the Etsy API. The structure is based on the organization of the Etsy API documentation. Methods are organized based upon their "Type" such as Listing, User, etc.
Table of Contents
- Quick Start
- Requests
- Results
- OAuth
- Provisional Users
- Advanced
- Development
Quick Start
Install via Composer by running:
Usage to access all featured listings:
Requests
All requests originate with the EtsyClient
object and are referenced as properties. These generally correspond to the Etsy API documentation with some variations. Three additional types are included but not documented: application
, baseline
and server
. These are only referenced by results from the getMethodTable method.
Parameters
Parameters are specified using an array passes directly into the method you are performing.
Fields
If you wish to specify fields to be returned then specify them first as an array.
Associations
Etsy allows you to request additional Associations be returned with your request. You must specify these first as an array.
Data
All PATCH
, POST
and PUT
requests also accept an array of data.
Results
The POST
method will always return an EtsyObject
as the response. The GET
method will return either a EtsyResults
or EtsyObject
based on how many items are expected to be returned. If you are fetching a listing then an EtsyObject
will be returned while if you are fetching active listings then EtsyResults
will be returned.
All other requests (PUT
, PATCH
, DELETE
) will return a true
or false
depending upon their response.
Note: return values have been generated automatically then manually reviewed. Please create an issue or pull request if value is not as expected.
EtsyResults
The EtsyResults
object is a simple iterable and array accessible collection. All items within the collection are instances of EtsyObject
. A few basic methods are available:
EtsyObject
This simple object allows you to access the individual results as properties via magic methods.
OAuth Requests
All methods which require a permission scope will need oauth access via an access and secret token. An easy way to generate these is by using y0lk/oauth1-etsy
. You'll specify these values when creating the EtsyClient
object.
Provisional Users
By default, only the user who owns the application can authenticate and use it via oauth. To allow other users to use your application you must either request "full access" via the Etsy developers site or by adding them as provisional users. This is made possible by two included method calls:
Advanced
If you prefer to receive the full response then use the raw()
function on your request.
Development
The generate.php
file is included which creates resources based upon all known types returned from the API. This is meant to serve as a starting point when major changes are made to the API.
All versions of etsy-php with dependencies
ext-json Version *
guzzlehttp/oauth-subscriber Version ^0.6.0