REST API

A Lambda function that handles GET/POST requests from a REST API and loads/stores records into a DynamoDB table.

Architecture

The template sets up:

1. API Gateway - REST API: Receives requests from the user.
2. AWS Lambda function: Handles user requests.
3. Amazon DynamoDB table: Stores and retrieves items as per the user request.

Code

• Function code: templates/api
• Unit tests: tests/api
• Infra stack: infra/stacks/api.py

Deployment

Deploy the stack using:

make deploy STACK=api

Endpoints

Endpoint	Description	Response codes
GET /items/{id}	Retrieve an item by ID	200, 404, 500
POST /items	Create a new item	201, 422, 500

Item model

Field	Type	Description
id	UUID string	Unique item identifier (auto-generated)
name	string	Human-readable item name

Environment variables

Variable	Description
TABLE_NAME	DynamoDB table name
SERVICE_NAME	Powertools service name
METRICS_NAMESPACE	Powertools metrics namespace