Skip to content

apisnetworks/apiscp-modules

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

89 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

apnscp Logo

apnscp

Artistic License Open Source release of all backend modules that power our control panel, apnscp. Modules may be interacted with by creating an API key in the control panel (Dev > API Keys). Use the endpoint cited in API Keys to correctly call the API.

Structure

Modules are laid out by module name. Each module name contains exposed public methods that may be invoved through the API. Any method prefixed with _ or marked as PRIVILEGE_SERVER_EXEC may not be directly invoked, but may be indirectly through same-module chaining. Permissions are evaluated before calling the module entry point. A module that calls a method in itself (same-module chaining) does not abide by permissions.

Methods may elevate the privileges through query() to speak with the backend service broker (apnscpd). apnscpd runs these methods with elevated privileges (root). Typically this is used sparingly when it is absolutely necessary.

Sample code

For example, to get server uptime, call get_uptime() in the common module:

  $endpoint = 'http://cp.apisnetworks.com:2082';
  $key = '1111-2222-3333-44444';
  $client = new SoapClient(
    $endpoint . '/apnscp.wsdl',
      array(
      'connection_timeout' => 5,
      'location'           => $endpoint.'/soap?authkey='.$key,
      'uri'                => 'urn:net.apnscp.soap'
    )
  );
  print call_user_func(array($client, 'common_get_uptime'));

Returns 2 months 17 days 15 hours 32 mins (or however long the server has been up).

Releases

No releases published

Packages

No packages published