The pb33f demo giftshop API
Play around with our demo APIThe Giftshop API
In order to try out wiretap, we’ve created a small demo API that you can use to play around with. The API is a simple giftshop API that has a few sample endpoints.
The API cannot be damaged in any way, so feel free to try out any of the features of wiretap on it. No mutations will be persisted, nothing will be deleted, and no data will be lost.
The OpenAPI Specification
The OpenAPI specification for the API is available at https://api.pb33f.io/wiretap/giftshop-openapi.yaml
Check the Giftshop OpenAPI specification quality using vacuum by clicking here
Available endpoints
Endpoint | Method | Description |
---|---|---|
Get all products, can be filtered with category query param. |
||
Create a new product. | ||
Get a specific product by productId . |
||
Update an existing product. | ||
Delete an existing product | ||
Search products for a keyword |
Product schema
properties:
id:
type: [string]
format: uuid
description: "The unique identifier for the product"
example: "d1404c5c-69bd-4cd2-a4cf-b47c79a30112"
shortCode:
type: [ string ]
description: "a short code for the product, easily human readable"
example: "pb0001"
name:
type: [string]
description: "The name of the product"
example: "pb33f t-shirt"
description:
type: [string]
description: "A description of the product"
maxLength: 500
example: "A t-shirt with the pb33f logo on the front"
price:
type: [number]
format: float
description: "The price of the product, as a floating point number"
example: 19.99
category:
type: [string]
description: "The category of the product"
example: "shirts"
image:
type: [string]
description: "The URL of the product image"
example: "https://pb33f.io/images/t-shirt.png"
Example product JSON
{
"id": "d91a1cc2-ec4e-468a-97dc-7a0325017f1b",
"shortCode": "pb0001",
"name": "pb33f t-shirt",
"description": "A t-shirt with the pb33f logo on the front",
"price": 19.99,
"category": "clothes",
"image": "https://pb33f.io/images/t-shirt.png"
}
API Base URL
The Giftshop API is available at https://api.pb33f.io/wiretap/giftshop
Get all products
Retrieve all products from the Giftshop API.
Parameters
Name | In | Description |
---|---|---|
category |
query |
Filter products by category, for example ‘clothes’. |
Response
Returns an array
of Product
objects.
cURL example
Get product by ID
Retrieve a Product
from the Giftshop API by productId
. This is the shortCode
of the product.
Parameters
Name | In | Description |
---|---|---|
productId |
path |
The shortCode of the product to view. |
Response
Returns a Product
object.
cURL Example
Create a product
Create a new Product
in the Giftshop.
Parameters
Name | In | Description |
---|---|---|
X-API-Key |
header |
Example API Key to use (required). |
Request Body
Content Type: application/json
Schema: Product
object
Response
Returns a Product
object, echoing the newly created product.
cURL example
Update a product
Update an existing Product
in the Giftshop.
Parameters
Name | In | Description |
---|---|---|
X-API-Key |
header |
Example API Key to use (required). |
Request Body
Content Type: application/json
Schema: Product
object
Response
Returns the updated Product
object,
cURL example
Delete a product
Delete a Product
from the Giftshop.
Parameters
Name | In | Description |
---|---|---|
X-API-Key |
header |
Example API Key to use (required). |
Response
Returns an empty object.
cURL example
Search products
Retrieve all products from the Giftshop API.
Parameters
Name | In | Description |
---|---|---|
category |
query |
Keyword to search products for. |
Response
Returns an array
of Product
objects.