Endpoints

Create a New Agent

• URL: /api/agent/new
• Method: POST
• Description: Create a new agent and store its information in a MySQL database.
• Request Body:
  • versionOS (required): The version of the operating system running on the agent.
  • host (required): The host name or IP address of the agent.
  • hookUser (required): The hook user of the agent.
• Response:
  • Status Code: 200 OK on success, 400 Bad Request if parameters are missing or invalid, 500 Internal Server Error if an error occurs during database insertion.
  • Response Body:

{
  "data": {
    "id": "<agentId>",
    "publicKey": "<publicKey>"
  },
  "error": {}
}

• Example:

POST /api/agent/new HTTP/1.1
Host: localhost:5000
Content-Type: application/json

{
  "versionOS": "1.0",
  "host": "example.com",
  "hookUser": "john.doe"
}

Upload a File

• URL: /api/file/upload/:user_folder
• Method: POST
• Description: Upload a file and save it in the specified user folder.
• Request Parameters:
  • user_folder (required): The user folder to which the file should be uploaded.
• Request Body:
  • The file to be uploaded should be sent as multipart/form-data with the file field name set to file.
• Response:
  • Status Code: 200 OK on success, 400 Bad Request if no file is uploaded.
  • Response Body:

{
  "data": {
    "success": "<filename> uploaded successfully."
  },
  "error": {}
}

• Example:

POST /api/file/upload/123 HTTP/1.1
Host: localhost:5000
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="example.txt"
Content-Type: text/plain

This is the content of the file.

------WebKitFormBoundary7MA4YWxkTrZu0gW--