Llamada a las API Create

Acceder a las API Create con solicitudes POST de HTTP. Las API Create insertan entradas de recurso nuevas en la base de datos.

Las solicitudes Create de REST utilizan los siguientes tipos de API, en función del Nombre del recurso que se ha especificado:

  • manageName (con Operation=Create)
  • manageNameHierarchy (con Operation=Create)
  • createName
  • createNameHierarchy

Por ejemplo, las solicitudes Create para las órdenes utilizan createOrder y las solicitudes Create para las organizaciones utilizan manageOrganizationHierarchy. Para ver la lista completa de recursos y API, vea los archivos Javadoc de REST.

Formato de solicitud

Utilice el siguiente formato de solicitud HTTP para llamar a las API Create:

POST https://host:port/contextRoot/restapi/Name

Nombre es el tipo de recurso que desea crear.

El ejemplo siguiente muestra una solicitud Create para una orden:
POST https://host:port/contextRoot/restapi/order

Crear o modificar

Puede utilizar las API "manage" para actualizar un recurso si existe o para crear el recurso si no existe en una única solicitud de crear o modificar (Create-Or-Modify). Para crear o modificar mediante REST, envíe un PATCH al Nombre de la colección de recursos y pase un documento que describa el recurso en el cuerpo de la solicitud.
PATCH https://host:port/contextRoot/restapi/Name
La característica Create-Or-Modify sólo es compatible con tipos de recursos que utilizan las API "manage". Por ejemplo, los artículos utilizan manageItem y las organizaciones utilizan manageOrganizationHierarchy, de modo que pueda crear o modificar artículos y organizaciones con PATCH. Consulte los archivos Javadoc para ver si un tipo de recurso utiliza las API "manage".