Connection API
- Rich Kalsky
- Nicholas Cook
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"
}
}