Server API

Base URL: http://localhost:8080

Authentication: Basic Auth (admin:admin by default)

PeSIT Servers

List Servers

GET /api/servers
Authorization: Basic YWRtaW46YWRtaW4=

Response:

[
  {
    "serverId": "PESIT_SERVER",
    "port": 6502,
    "tlsPort": 5001,
    "status": "RUNNING",
    "autoStart": true,
    "activeConnections": 2
  }
]

Create a Server

POST /api/servers
Content-Type: application/json

{
  "serverId": "PESIT_SERVER",
  "port": 6502,
  "tlsPort": 5001,
  "autoStart": true,
  "maxConnections": 100,
  "readTimeout": 60000
}

Start a Server

POST /api/servers/{serverId}/start

Response:

{
  "serverId": "PESIT_SERVER",
  "status": "RUNNING",
  "message": "Server started"
}

Stop a Server

POST /api/servers/{serverId}/stop

Server Status

GET /api/servers/{serverId}/status

Response:

{
  "serverId": "PESIT_SERVER",
  "status": "RUNNING",
  "port": 6502,
  "tlsPort": 5001,
  "activeConnections": 2,
  "totalTransfers": 1523,
  "uptime": 86400
}

Partners

List Partners

GET /api/v1/config/partners

Response:

[
  {
    "partnerId": "CLIENT_XYZ",
    "name": "Client XYZ",
    "enabled": true,
    "lastConnection": "2025-01-10T10:30:00Z",
    "transferCount": 150
  }
]

Create a Partner

POST /api/v1/config/partners
Content-Type: application/json

{
  "partnerId": "CLIENT_XYZ",
  "name": "Client XYZ",
  "password": "secret123",
  "enabled": true,
  "allowedOperations": ["READ", "WRITE"]
}

Get a Partner

GET /api/v1/config/partners/{id}

Update a Partner

PUT /api/v1/config/partners/{id}
Content-Type: application/json

{
  "name": "Client XYZ (Production)",
  "enabled": true
}

Delete a Partner

DELETE /api/v1/config/partners/{id}

Virtual Files

List Virtual Files

GET /api/v1/config/files

Response:

[
  {
    "fileId": "TRANSFERS",
    "name": "Transfer files",
    "sendDirectory": "/data/send/transfers",
    "receiveDirectory": "/data/received/transfers",
    "filenamePattern": "*.xml"
  }
]

Create a Virtual File

POST /api/v1/config/files
Content-Type: application/json

{
  "fileId": "TRANSFERS",
  "name": "Transfer files",
  "sendDirectory": "/data/send/transfers",
  "receiveDirectory": "/data/received/transfers",
  "filenamePattern": "*.xml"
}

Get a Virtual File

GET /api/v1/config/files/{id}

Update a Virtual File

PUT /api/v1/config/files/{id}

Delete a Virtual File

DELETE /api/v1/config/files/{id}

Cluster

Cluster Status

GET /api/cluster/status

Response:

{
  "clusterName": "pesitwizard-cluster",
  "isLeader": true,
  "nodeName": "pesitwizard-server-abc123",
  "members": [
    {
      "name": "pesitwizard-server-abc123",
      "address": "10.42.0.100",
      "isLeader": true
    },
    {
      "name": "pesitwizard-server-def456",
      "address": "10.42.0.101",
      "isLeader": false
    }
  ],
  "memberCount": 2
}

Transfer History

List Transfers

GET /api/v1/transfers?page=0&size=20

Query parameters:

Parameter	Description
partnerId	Filter by partner
direction	SEND or RECEIVE
status	COMPLETED, FAILED
from	Start date
to	End date

Response:

{
  "content": [
    {
      "id": 1,
      "partnerId": "CLIENT_XYZ",
      "direction": "RECEIVE",
      "filename": "TRANSFER.XML",
      "virtualFileId": "TRANSFERS",
      "size": 15234,
      "status": "COMPLETED",
      "startTime": "2025-01-10T10:30:00Z",
      "endTime": "2025-01-10T10:30:05Z"
    }
  ],
  "totalElements": 1523
}

Health & Monitoring

Health Check

GET /actuator/health

Prometheus Metrics

GET /actuator/prometheus

Info

GET /actuator/info