insert 调用

insert 调用用于使用指定的值创建特定类型的新记录（实体）。

insert 请求 - 除常规的登录 ID 和密码参数外，insert 调用还需要以下参数：      

在插入期间，您不需要为该实体类型指定所有字段。 除那些在 describe 响应中标记为必需的字段（通过布尔值为“0”的属性“nullable”指示）外，大多数字段都为可选字段。 未指定的字段将设置为空或默认值。 太长的字段将会截断。

当您在 insert 请求中发送无法识别的字段值时，Web 服务 API 拒绝此调用。 因此将传输状态代码 300，如以下消息所示：

Rejecting the value that is supplied for input data element "{ 0} "; due to a correlation failure because the data transformation process could not resolve the supplied input data element into native format.

API 对无法识别的字段值应用严格的定义，以便调用中的所有字段对该操作的用户都必须有效。

例如：

• API 拒绝为已从用户的访问权限中删除或移除的自定义字段指定值的调用。
• API 拒绝指定只读字段的调用。

对于某些类型的实体，如果您尝试插入已经存在的记录，API 将不会插入新记录。

insert 响应

所有 API 调用的默认服务响应都包含将要以 insert 调用所请求的输出格式插入的记录的记录标识符（行 ID）。