getObjects

Retrieve your custom objects.

ERPLY has an object storage where you can store custom data for plug-ins, integrations etc.

For other object storage functions, see getObjects, saveObject, deleteObject (which allow to manipulate whole objects), and incrementAttributeValue, decrementAttributeValue — which provide a way to atomically increment or decrement one numeric field of a specific object (eg. to implement a counter).

Input parameters

Parameter name Description Possible value Required
objectID  Object ID. Retrieve one specific object.  Integer    
group  Group name. Retrieve all objects from one specific group.

A group is like a "database table" for your custom relational objects. All objects in one group should have approximately the same data fields.

Object IDs are globally unique (ie., not per-group unique); if you look up an object by ID, leave the "group" field unspecified. 
String    
searchAttributeName1
searchAttributeValue1 
Search for an object that has a specific field value.

For example, if you using object storage to store vehicles (that have a license plate number), you may look up a vehicle with the following query: searchAttributeName1 = "licensePlate", searchAttributeValue1 = "ABC1234".

It is possible to use only one attribute filter right now, although searching by multiple attributes may be supported in the future.

 
   
partnerKey  To use object storage, you need an API partner key. Contact ERPLY customer support to get one.  String  yes  
recordsOnPage  Number of records API should return. By default 20, at most 100.  Integer    
pageNo  API returns at most recordsOnPage items at a time. To retrive the next recordsOnPage items, send a new request with pageNo incremented by one. By default, API returns "page 1".  Integer    

Response

Field name Type Description
objectID  Integer    
group  String    
attributes  Array  Array, each item in which has the following parameters:

attributeName - String - name of the attribute
attributeType - String - type of the attribute
attributeValue - value of the attribute.