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"
    }
}