POST Agents/BLOB/SaveBlobEntity

• 5 minutes to read
 • 5 minutes to read 
POST /api/v1/Agents/BLOB/SaveBlobEntity

Updates the existing BlobEntity or creates a new BlobEntity if the id parameter is 0.

NsApiSlow threshold: 3000 ms.

Request Headers

Parameter Name Description
Authorization Supports 'Basic', 'SoTicket' and 'Bearer' schemes, depending on installation type.
X-XSRF-TOKEN If not using Authorization header, you must provide XSRF value from cookie or hidden input field
Content-Type Content-type of the request body: application/json, text/json, application/xml, text/xml, application/x-www-form-urlencoded, application/json-patch+json, application/merge-patch+json
Accept Content-type(s) you would like the response in: application/json, text/json, application/xml, text/xml, application/json-patch+json, application/merge-patch+json
Accept-Language Convert string references and multi-language values into a specified language (iso2) code.
SO-Language Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value.
SO-Culture Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set.
SO-TimeZone Specify the timezone code that you would like date/time responses converted to.
SO-AppToken The application token that identifies the partner app. Used when calling Online WebAPI from a server.

Request Body: blobEntity

The BlobEntity that is saved

Property Name Type Description
BlobId Integer Primary key
BlobSize Integer The length, in bytes, of the binary data AS STORED after any encryption and/or zipping. Important to get right, since some databases will not tell us just based on the blob itself!
Description String A description that is entered by the user, and visible to the user
ExtraInfo String Extra information, spare field, can be used for anything that makes sense. Should not refer to any particular context, that is something for the BinaryObjectLInk
IsEncrypted Boolean Has the data been encrypted.
IsZipped Boolean Has the data been zipped.
MimeType String Mime type, describing the technical type (image/jpeg) of the data
OriginalSize Integer Original size of the binary data, before encryption and/or zipping. This is what the ultimate client will get
CreatedDate String Registered when in UTC.
UpdatedDate String Last updated when in UTC.
CreatedBy Associate The person that first created the document. The property is read-only.
UpdatedBy Associate The person that last updated the appointment.
ConceptualType String The type, for instance PHOTO, PERSONPHOTO, or whatever, that is descriptive of what kind of image or data this is

Response:

OK

Response Description
200 OK

Response body: BlobEntity

Property Name Type Description
BlobId int32 Primary key
BlobSize int32 The length, in bytes, of the binary data AS STORED after any encryption and/or zipping. Important to get right, since some databases will not tell us just based on the blob itself!
Description string A description that is entered by the user, and visible to the user
ExtraInfo string Extra information, spare field, can be used for anything that makes sense. Should not refer to any particular context, that is something for the BinaryObjectLInk
IsEncrypted bool Has the data been encrypted.
IsZipped bool Has the data been zipped.
MimeType string Mime type, describing the technical type (image/jpeg) of the data
OriginalSize int32 Original size of the binary data, before encryption and/or zipping. This is what the ultimate client will get
CreatedDate date-time Registered when in UTC.
UpdatedDate date-time Last updated when in UTC.
CreatedBy Associate The person that first created the document. The property is read-only.
UpdatedBy Associate The person that last updated the appointment.
ConceptualType string The type, for instance PHOTO, PERSONPHOTO, or whatever, that is descriptive of what kind of image or data this is
TableRight TableRight The carrier's table right
FieldProperties object Field property dictionary mapping field names to field access rights.

Sample request

POST /api/v1/Agents/BLOB/SaveBlobEntity
Authorization: Basic dGplMDpUamUw
Accept: application/json; charset=utf-8
Accept-Language: fr,de,ru,zh
Content-Type: application/json; charset=utf-8

{
  "BlobId": 563,
  "BlobSize": 970,
  "Description": "Up-sized bi-directional Graphical User Interface",
  "ExtraInfo": "atque",
  "IsEncrypted": false,
  "IsZipped": true,
  "MimeType": "voluptas",
  "OriginalSize": 887,
  "CreatedDate": "2016-12-29T02:30:46.8194719+01:00",
  "UpdatedDate": "2007-06-04T02:30:46.8194719+02:00",
  "CreatedBy": null,
  "UpdatedBy": null,
  "ConceptualType": "assumenda"
}

Sample response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "BlobId": 352,
  "BlobSize": 993,
  "Description": "Polarised fresh-thinking core",
  "ExtraInfo": "corporis",
  "IsEncrypted": false,
  "IsZipped": false,
  "MimeType": "nihil",
  "OriginalSize": 186,
  "CreatedDate": "2017-03-18T02:30:46.8194719+01:00",
  "UpdatedDate": "2003-06-25T02:30:46.8194719+02:00",
  "CreatedBy": null,
  "UpdatedBy": null,
  "ConceptualType": "sint",
  "TableRight": null,
  "FieldProperties": {
    "fieldName": {
      "FieldRight": null,
      "FieldType": "System.Int32",
      "FieldLength": 502
    }
  }
}