info:
  name: Initiate Device Registration
  type: http
  seq: 1
http:
  method: POST
  url: '{{base_url}}/api/devices/register'
  auth: none
  body:
    type: json
    jsonBody: "{\n    \"device_name\": \"My Kindle Paperwhite\",\n    \"device_type\"\
      : \"koreader\",\n    \"device_identifier\": \"kindle-pw5-hardware-id-12345\""

docs: |-
  ## Initiate Device Registration
  
    Initiates a new device registration request that requires admin approval.
  
    **Method:** POST
  
    **Endpoint:** /api/devices/register
  
    **Authentication:** None (open endpoint)
  
    **Request Body:**
    - `device_name` (string, required): Human-readable device name (max 100 chars)
    - `device_type` (string, required): Device type (kobo, koreader, kindle, etc.)
    - `device_identifier` (string, required): Unique hardware ID (max 200 chars)
  
    **Response:**
    - `registration_id` (string): Unique registration request ID
    - `status` (string): Initial status (pending)
    - `expires_at` (string): Expiration timestamp (usually 24 hours)
    - `message` (string): Informational message
  
    **Status Codes:**
    - 201: Registration initiated
    - 400: Invalid request
    - 409: Device already registered