API Documentation

Integrate WisPanel with your applications using our comprehensive REST API.

Base URL

https://your-server-ip:2083/api/v1

All API endpoints are relative to this base URL.

Software β€” PHP

Software β€” PHP

Manage PHP versions, config, extensions, CustomBuild. Role: admin.


Installed β€” GET /api/v1/software/php

Response 200 (verified live):

{ "installed": [
    { "version": "8.5", "full_version": "8.5.2",
      "path": "/usr/local/php85/bin/php",
      "fpm_socket": "/run/php/php85-fpm.sock",
      "lsphp_path": "/usr/local/lsws/fcgi-bin/lsphp-8.5.2",
      "config_path": "/usr/local/php85/etc/php/",
      "is_active": true, "is_default": true, "mode": "php-fpm" } ] }

GET /software/php/available β†’ { "available": ["7.1", "7.0"] } (verified live β€” versions not yet installed).

Manage

POST /software/php/install Request: { "version": "8.3" } β†’ { "success": true, "version": "8.3" }. POST /software/php/:version/default Β· /restart (no body); GET /software/php/:version/info; DELETE /software/php/:version.

Config & extensions

GET | PUT /software/php/:version/config PUT Request: { "memory_limit": "256M", "upload_max_filesize": "64M" }. GET | POST /software/php/:version/extensions Request: { "extension": "redis" }; POST /:version/extensions/:ext/enable Β· /disable; DELETE /:version/extensions/:ext.

CustomBuild β€” /api/v1/custombuild

GET /custombuild/php/versions Β· /php/extensions. PUT /custombuild/php/extensions/:extension { "enabled": true }. POST /custombuild/php/rebuild-with-extension { "version": "8.2", "extension": "imagick" }.


Conventions β†’ Authentication, Error Handling.

Rate Limiting

API requests are limited to 60 requests per minute per API token.

  • X-RateLimit-Limit: Maximum requests per minute
  • X-RateLimit-Remaining: Remaining requests
  • X-RateLimit-Reset: Unix timestamp when limit resets