Connection API

Client Connections

The first step to using Pinogy’s API is to be able to log in.  Sample implementations are available for:

Python: https://bitbucket.org/pinogycorp/po_clients/src/master/python/

PHP: https://bitbucket.org/pinogycorp/po_clients/src/master/php/

C#: https://bitbucket.org/pinogycorp/po_clients/src/master/csharp/

In addition, you will need to obtain the API host, access key, secret key, and password for each client.

Creating a session

POST /apps/any/sessions

Resource accepts the following arguments:

  • accesskey - API access key

  • timestamp - current timestamp in YYYY-MM-DDTHH:mm:SSZ format

  • signature - signature (calculated internally by client library)

  • app_id - Pinogy application id (3 = Pet Tracker, 4 = Cash Register, additional can be provided as needed.)

  • password - password

  • version - calling software version

  • os - OS name (Windows/macOS)

Response

{ "clientid": 222, "device": { "id": 372, "name": "device-name-sep3-20 @ FF" }, "id": 618317, "language": "en_US", "location": { "addressline1": "4904 Washington", "addressline2": "", "city": "West Point", "email": "sales@store.com", "id": 7, "name": "Foo Fighters - business", "phonenumber": "765-427-4803", "receiptname": "Foo Fighters", "state": "WA", "zipcode": "47992" }, "started": "2023-11-09 15:49:16.187439+00:00", "token": "m3UkPjm/sq//AePU/eTniCMrk07ddg==", "updated": "2023-11-09 15:49:16.187450+00:00", "user": { "displayname": "Pinogy Support - Dev 222", "id": 28297, "name": "Pinogy Support - Dev 222", "rolename": "Admin", "roles": [ { "app_ids": [ 4, 7, 3, 1 ], "deleted": false, "group": "Entity", "id": -3, "name": "Customer", "parent_id": null } ], "username": "Pinogy Support - Dev 222" } }