chore: update web readme

Author: sliedig

unicorn_web/README.md

@@ -4,15 +4,27 @@
 
 ## Architecture Overview
 
-Unicorn Web is primarily responsible for allowing customers to search and view property listings. It also supports ability for agents to request approval for specific property. Those approval requests are sent to Property service for validation, before Properties table is updated with approval evaluation results.
+Unicorn Web lets customers search for and view property listings. The Web API also allows Unicorn Properties agents to request approval for specific properties that they want to publish so they may be returned in customer searches results. These requests are sent to the Unicorn Approvals service for validation.
 
-A core component of Unicorn Web are the Lambda functions which are responsible with completing API Gateway requests to:
+Lambda functions handle API Gateway requests to:
 
-- search approved property listings
-This function interacts with DynamoDB table to retrieve property listings marked as `APPROVED`. The API Gateway implementation and lambda code support multiple types of search patterns, and allow searching by city, street, or house number.
+- Search approved property listings: The **Search function** retrieves property listings marked as APPROVED from the DynamoDB table using multiple search patterns.
 
-- request approval of property listing
-This function sends an event to EventBridge requesting an approval for a property listing specified in the payload sent from client
+- Request property listing approval: The **Approval function** sends an EventBridge event requesting approval for a property listing specified in the payload.
 
-- publication approved function
-There is also a lambda function responsible for receiving any "Approval Evaluation Completed" events from EventBridge. This function writes the evaluation result to DynamoDB table.
+- Process approved listings: The **Publication Evaluation Event Handler function** processes `PublicationEvaluationCompleted` events from the Unicorn Approvals service and writes the evaluation result to the DynamoDB table.
+
+### Testing the APIs
+
+```bash
+export API=`aws cloudformation describe-stacks --stack-name uni-prop-local-web --query "Stacks[0].Outputs[?OutputKey=='ApiUrl'].OutputValue" --output text`
+
+curl --location --request POST "${API}request_approval" \
+--header 'Content-Type: application/json' \
+--data-raw '{"PropertyId": "usa/anytown/main-street/111"}'
+
+
+curl -X POST ${API_URL}request_approval \
+    -H 'Content-Type: application/json' \
+    -d '{"PropertyId":"usa/anytown/main-street/111"}' | jq
+```