Scripted rest api retrieve incident (#53)

* Add Scripted REST API for Incident Data Retrieval

This commit implements a new Scripted REST API in ServiceNow to allow external applications to retrieve specific incident data based on query parameters. 

Key Features:
- API Endpoint:  `/api/incident/retrieve` 
- Supports query parameters such as `sys_id` and `state` to filter incidents.
  
Script Logic:
  - Utilizes GlideRecord to query the `incident` table.
  - If `sys_id` is provided, retrieves the specific incident; otherwise, queries based on the `state`.

Response Formatting:
  - The response is structured in JSON format, providing incident details like `sys_id`, `short_description`, and `state`.

Testing:
- Instructions for testing the API and documentation for developers on how to use it have been included.

* Rename scripted_rest_api_incident_retrieve.js to Scripted Rest API Retrieve Incident.js

This commit implements a new Scripted REST API in ServiceNow to allow external applications to retrieve specific incident data based on query parameters.

Author: ynr-ram

Prompts/Scripted Rest API Retrieve Incident.js

@@ -0,0 +1,40 @@
+Prompt: Develop a Scripted REST API in ServiceNow to retrieve specific incident data based on query parameters. This API should allow external applications to access incident details in a structured format.
+
+Structure: Outline the steps for creating the API, including endpoint definitions, input parameters, and response formatting.
+
+Expected Output:
+
+Define API Endpoint:
+
+Specify the endpoint (e.g., /api/incident/retrieve).
+List accepted query parameters (e.g., sys_id, state).
+  
+Script Logic:
+Provide a script to query incidents based on parameters.
+  
+Example:
+var gr = new GlideRecord('incident');
+if (current.sys_id) {
+    gr.get(current.sys_id);
+} else {
+    gr.addQuery('state', current.state);
+    gr.query();
+}
+
+Response Formatting:
+Format the response in JSON.
+Example:
+var response = {};
+response.incidents = [];
+while (gr.next()) {
+    response.incidents.push({
+        sys_id: gr.sys_id,
+        short_description: gr.short_description,
+        state: gr.state
+    });
+}
+return new sn_ws.Response(response);
+Testing and Documentation:
+
+Include instructions for testing the API.
+Provide documentation for developers on how to use the API.