Welcome to the Widgets API documentation! This guide provides details on how to interact with the Widgets service via HTTP requests. 📚
📋 Endpoints Overview
Method | Path | Description |
---|---|---|
GET |
/Widgets |
Retrieve a list of available widgets |
POST |
/Widgets |
Create a new widget |
GET |
/Widgets/{id} |
Get details of a specific widget |
PUT |
/Widgets/{id} |
Update an existing widget |
DELETE |
/Widgets/{id} |
Remove a widget |
📌 Parameters & Responses
List Widgets
- Query Parameters:
page
,limit
,sort
- Response: JSON array of widget objects with
id
,name
, anddescription
fields - Example:
curl https://api.example.com/Widgets?page=1&limit=10
- Query Parameters:
Create Widget
- Request Body:
name
,description
,type
- Status Codes:
201 Created
– Success400 Bad Request
– Missing parameters
- Example:
curl -X POST https://api.example.com/Widgets -H "Content-Type: application/json" -d '{"name": "Clock", "description": "A real-time widget"}'
- Request Body:
🖼️ Visual Examples
For more details on widget types, check out our Widget Design Guide. 🛠️
📚 Related Documentation
- API Overview – Learn about the core API concepts
- Widget Configuration – Dive deeper into widget settings
Let us know if you need further assistance! 💡