API Reference

Complete documentation of all available endpoints and their usage.

Endpoints

GUID Generator Endpoints

GET /guids

Display the GUID generator interface.

Response: HTML page with generator form

POST /guids/generate

Generate GUIDs based on specified options.

Request Body:
{
  "Count": 5,
  "Uppercase": false,
  "IncludeHyphens": true,
  "IncludeBraces": false
}
Parameters:
  • Count (int): Number of GUIDs to generate (1-100)
  • Uppercase (bool): Generate uppercase GUIDs
  • IncludeHyphens (bool): Include hyphens in format
  • IncludeBraces (bool): Wrap GUIDs in braces
Response:

HTML fragment containing generated GUIDs

People Generator Endpoints

GET /people

Display the people generator interface.

Response: HTML page with generator form

POST /people/generate

Generate people data with optional contact information.

Request Body:
{
  "Count": 10,
  "IncludeEmail": true,
  "IncludePhone": true,
  "IncludeAddress": true,
  "Append": false
}
Parameters:
  • Count (int): Number of people to generate (1-100)
  • IncludeEmail (bool): Include email addresses
  • IncludePhone (bool): Include phone numbers
  • IncludeAddress (bool): Include postal addresses
  • Append (bool): Append to existing results
Response:

HTML fragment containing person cards

Orders Generator Endpoints

GET /orders

Display the orders generator interface.

Response: HTML page with generator form

POST /orders/generate

Generate order data with customer and item information.

Request Body:
{
  "Count": 5,
  "ItemsPerOrder": 3,
  "IncludeCustomerPhone": true,
  "IncludeCustomerAddress": true,
  "Append": false
}
Parameters:
  • Count (int): Number of orders to generate (1-100)
  • ItemsPerOrder (int): Items per order (1-10)
  • IncludeCustomerPhone (bool): Include customer phone
  • IncludeCustomerAddress (bool): Include customer address
  • Append (bool): Append to existing results
Response:

HTML fragment containing order cards

Authentication & Security

All POST requests require a valid antiforgery token for security.
Antiforgery Token

Include the antiforgery token in the request header:

// Get token from form or meta tag
const token = document.querySelector('input[name="__RequestVerificationToken"]').value;

// Include in request headers
fetch('/people/generate', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'RequestVerificationToken': token
    },
    body: JSON.stringify(requestData)
});

Error Handling

HTTP Status Codes
  • 200 OK - Request successful
  • 400 Bad Request - Invalid parameters or missing antiforgery token
  • 404 Not Found - Endpoint not found
  • 500 Internal Server Error - Server error
Validation Errors

Parameter validation errors return detailed information:

{
  "Count": ["The field Count must be between 1 and 100."],
  "ItemsPerOrder": ["The field ItemsPerOrder must be between 1 and 10."]
}
Rate Limiting: For optimal performance, avoid generating more than 100 items per request. Use multiple smaller requests for larger datasets.