PolychartService
Upsert Drawing
Create or update a drawing using optimistic concurrency on the parent layer.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/v1/polychart/drawings' \
--header 'Accept: */*' \
--header 'X-API-KEY-ID: YOUR_API_KEY_ID' \
--header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \
--header 'X-API-SIGNATURE: YOUR_API_SIGNATURE' \
--header 'Content-Type: application/json' \
--data '{
"drawing": {
"bboxPriceMax": 61000.25,
"bboxPriceMin": 61000.25,
"bboxTimeMaxMs": "1",
"bboxTimeMinMs": "1",
"clientUpdatedAtMs": "1",
"deletedAtMs": "1",
"drawingId": "1",
"engineSymbolId": 1,
"layer": {
"layerId": "1",
"ownerId": "1"
},
"ownerId": "1",
"payload": "AA==",
"type": 1,
"updatedAtMs": "1",
"version": 1
},
"expectedLayerRevision": "1"
}'Responses
{
"drawing": {
"bboxPriceMax": 61000.25,
"bboxPriceMin": 61000.25,
"bboxTimeMaxMs": "1",
"bboxTimeMinMs": "1",
"clientUpdatedAtMs": "1",
"deletedAtMs": "1",
"drawingId": "1",
"engineSymbolId": 1,
"layer": {
"layerId": "1",
"ownerId": "1"
},
"ownerId": "1",
"payload": "AA==",
"type": 1,
"updatedAtMs": "1",
"version": 1
},
"layerRevision": "1"
}Drawing payload to create or update.
Expected current revision of the parent layer.
Account that owns the drawing.
1Drawing identifier unique within the owner account.
1Account that owns the layer.
1Layer identifier unique within the owner account.
1Engine symbol identifier for the drawing market.
1Client-defined drawing type identifier.
1Client-defined payload schema version.
1Serialized drawing payload bytes.
AA==Minimum drawing time bound in milliseconds since epoch (UTC); 0 means unset.
1Maximum drawing time bound in milliseconds since epoch (UTC); 0 means unset.
1Minimum drawing price bound; 0 means unset.
61000.25Maximum drawing price bound; 0 means unset.
61000.25Server-assigned commit timestamp in milliseconds since epoch (UTC).
1Server-assigned deletion timestamp in milliseconds since epoch (UTC); 0 means not deleted.
1Client-assigned commit timestamp in milliseconds since epoch (UTC), used for last-write-wins merge.
1New parent layer revision after mutation.
1| Key | Status | Error | When |
|---|---|---|---|
| unauthenticated | 401 | Unauthenticated | Authentication required. |
| permission-denied | 403 | Permission Denied | Permission denied. |
| invalid-argument | 400 | Invalid Argument | Invalid argument. |
| not-found | 404 | Not Found | Not found. |
| unavailable | 503 | Unavailable | Service unavailable. |