Pepperi API Design
Search…
PEPPERI NOTIFICATION SERVICE
PFS - Pepperi File Service
Actions Queue
CPI Node
TODO training
BatchPut
insert multiple objects to a table with a single call
post
https://api.pepperi.com
/v1.0/addons/data/batch/{addonUUID}/{table}
Batch put
  • BatchPut allows for up to 25 objects to be written to the ADAL table in a single call
WARNING: BatchPut completely overwrites any existing objects in the database with the same key, and is not merging them together. Any property in the already-existing object that is not included in the new object, will be deleted in the process.
Some objects might not be uploaded on the first try. BatchPut retries to upload those failed objects several times utilizing an exponential backoff algorithm for up to 13 seconds total.
Currently only exposed to DataImport, accepting only its secret key.
  • Maximum 25 objects as input
  • Maximum 6MB as input
  • A single object cannot exceed 400KB
Object upload is NOT ordered, i.e. the first object in the input array might be uploaded last. Therefore, any object in the input must be independent and not rely on other objects.
BatchPut takes as input an array of objects intended for upload to the ADAL table.
1
{
2
"Objects":
3
[
4
{
5
'Key': 'foo',
6
'Attribute1': 'something',
7
'Attribute2': 'something else'
8
},
9
{
10
// ...
11
}
12
]
13
}
Copied!
  • An input object MUST contain an attribute "Key", with the value being a unique key identifying this object in the ADAL table.
  • There must not be any duplicate objects (i.e. having the same key) in the input array.
Failing either one of these criteria will result in the failure of the entire operation.
BatchPut outputs an array of ImportedObject matching with the input array. This means that output.ImportedObjects[x] is an ImportedObject describing the operation result of the object input.Objects[x]. The status of a returned ImportedObject can only be "Inserted" or "Error".
Last modified 1mo ago
Copy link