Table collection services: POST response

The elements of an HTTP POST response for the creation of a row within a table collection in the ObjectServer.

Table 1. Table collection services: POST resposne
Element Description
Response headers
Server
The name of the HTTPd engine.
Date
The date or time of the response.
Connection
The state of the connection. Possible states are Close or Keep-Alive.
Location
The URI of the created resource.
Content-Type application/json
Normal HTTP response codes
  • 201 (Created): The URI of the inserted row is contained in the HTTP header Location of the response. The response body contains a JSON success message.
Error HTTP response codes
  • 400 (Bad Request): The JSON row set definition of the row to insert is invalid. The row is invalid because it contains missing, unknown or incorrect columns, or because insufficient or incorrect column values are provided.
  • 409 (Conflict): Primary key collision. The row already exists in the table.
  • 500 (Internal Server Error): The server failed to complete the request due to an unexpected internal problem. The response body contains the JSON error message with more information.

Other common HTTP error response codes are 401 (Unauthorised), 403 (Forbidden)406 (Not acceptable), and 415 (Unsupported Media Type).