Define an API resource request structure

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 1 min. de leitura

    • Add a schema to a REST request record to define the request's expected data structure.

    Antes de Iniciar

    You must define at least one REST API resource and at least one schema in the REST API before defining the request structure.

    Role required: web_service_admin

    Procedimento

    1. Navigate to a new REST Request record in one of the following ways.
      If you navigate through a scripted REST API record, most fields in the REST Request record are pre-populated.
      OptionProcedure
      Navigate through a scripted REST API record
      1. Navigate to All > System Web Services > Scripted REST APIs.
      2. Select a scripted REST API record.
      3. In the Resources related list, select a resource.
      4. In the Request Schema tab, select New.
      Navigate directly to a new REST Request record
      1. Navigate to All > Filter and enter sys_ws_request_spec.form.
      2. In the API field, select an API.
      3. In the API resource field, select the API resource whose request schema you want to specify.
      4. In the Version field, select the API resource version.
      5. In the Http method field, select the method whose request schema you want to specify (for example, PUT).
    2. In the Schema field, find or enter the schema you want to define the structure and format of the resource's request body.
    3. In the Description field, summarize the expected format of the REST request.
    4. Select Submit.

    Resultado

    The schema you used to define the request body structure is included in the exportable OpenAPI specification in the REST API Explorer. For more information about exporting OpenAPI specifications, see Export to OpenAPI specification.