Skip to main content
Altcraft Docs LogoAltcraft Docs Logo
User guideDeveloper guideAdmin guide
Company siteHelp center
English
  • Русский
  • English
v74
  • v74
  • v73
  • v72
Login
  • Getting Started
  • Administrator documentation
  • Functional characteristics
  • Technology description
  • System requirements
  • Admin Panel
  • Platform installation
  • Platform configuration
  • Platform maintenance
  • Custom channels guide
  • Extra
  • Processing HTTP/HTTPS traffic
  • Administrator API
    • Accounts admin api
    • Account users
    • Nodes
      • Synchronize node MTA configuration
      • Get nodes list
      • Get node MTA status
      • Activate node MTA
      • Deactivate node MTA
    • Senders admin api
    • Virtual senders
  • Administrator API
  • Nodes
  • Get nodes list
Documentation for version v74

Get nodes list

Description​

Retrieves Altcraft service instance nodes list.

Request URL​

Method: POST

https://example.com/api/v1.1/admin/nodes/list/

Request parameters​

ParameterTypeExampleRequiredDescription
tokenstring"abcdefghijklmnqrstuvwxyz"YesAPI token
formatstring"json"NoResponse data format
By default – json
from_idint1NoThe first node ID on the list
By default –1
limitint100NoNodes list limit
By default – 1000

Request example​

  • JSON
  • XML
{
"token": "abcdefghijklmnqrstuvwxyz"
}
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
</xml>

Response example​

  • JSON
  • XML
{
"data": [
{
"id": 1,
"name": "new",
"host": "localhost",
"mode": "SSL"
}
],
"error": 0,
"error_text": "Successful operation",
"total_count": 1
}
<xml>
<data>
<host>localhost</host>
<id>1</id>
<mode>SSL</mode>
<name>new</name>
</data>
<error>0</error>
<error_text>Successful operation</error_text>
<total_count>1</total_count>
</xml>

Response parameters​

ParameterTypeDescription
errorintError code
error_textstringError text
idintNode ID
namestringNode name
hoststringNode IP:port
modestring"HTTPS" or "SSH" mode
Last updated on Mar 16, 2024
Previous
Synchronize node MTA configuration
Next
Get node MTA status
  • Description
  • Request URL
  • Request parameters
  • Request example
  • Response example
  • Response parameters
© 2015 - 2025 Altcraft, LLC. All rights reserved.