Alumio Example API

Mock REST, GraphQL & SOAP API — 50 products & 50 orders — no auth required

Try in Swagger UI OpenAPI spec WSDL

Products

REST
MethodPathDescription
GET /products Paginated list — query params
POST PUT PATCH/products/listPaginated list — page/offset/limit in body
POST /products Create product (fake)
GET /products/{id} Get one product
PUT /products/{id} Full update (fake)
PATCH/products/{id} Partial update (fake)
DELETE/products/{id} Delete (fake)

Orders

REST
MethodPathDescription
GET /orders Paginated list — query params
POST PUT PATCH/orders/listPaginated list — page/offset/limit in body
POST /orders Create order (fake)
GET /orders/{id} Get one order
PUT /orders/{id} Full update (fake)
PATCH/orders/{id} Partial update (fake)
DELETE/orders/{id} Delete (fake)

Pagination

All endpoints
next-linklinks.next URL in every paginated response body
next-link-headerLink: <url>; rel="next" response header
query-page-parameter?page=N&limit=N — Alumio increments page
query-offset-parameter?offset=N&limit=N — Alumio increments offset
body-page-parameterPOST/PUT/PATCH /list with {"page":N} in body
Default page size10 items. Override with ?limit=N or "limit":N in body

Failure simulation

All endpoints
How to triggerAppend ?fail=<status_code> to any request
Examples?fail=500   ?fail=422   ?fail=429   ?fail=503
REST formatJSON {"error":{"code":N,"message":"..."}}
GraphQL formatJSON {"errors":[...]}
SOAP formatSOAP Fault envelope with soap:Server or soap:Client fault code

GraphQL

GraphQL
MethodPathDescription
POST /graphql Queries: products, product, orders, order
Mutations: createProduct, updateProduct, deleteProduct, createOrder, updateOrder, deleteOrder
Pagination via page, offset, limit arguments. Responses include links.next and Link header.
Example request body — POST /graphql
{ "query": "query GetProducts($page: Int, $limit: Int) { products(page: $page, limit: $limit) { data { id name price category } links { next } meta { total page limit } } }", "variables": { "page": 1, "limit": 10 } }

SOAP

SOAP 1.1
MethodPathDescription
GET/soap?wsdlWSDL definition
POST /soap GetProducts, GetProduct, CreateProduct, UpdateProduct, DeleteProduct
GetOrders, GetOrder, CreateOrder, UpdateOrder, DeleteOrder
Example request body — POST /soap (Content-Type: text/xml)
<?xml version="1.0" encoding="UTF-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tns="http://alumio.com/mockapi/"> <soap:Body> <tns:GetProducts> <tns:Page>1</tns:Page> <tns:Limit>10</tns:Limit> </tns:GetProducts> </soap:Body> </soap:Envelope>

AI & agent discoverability

Meta