passwd
Password Change API
Change the Eenos user account password.
Required Parameters
Field | Description | Example |
apiuser | The API username | eenos_api |
apiauth | The API user password | eenos123 |
user | The eenos account username | myclient |
Optional Parameters
Field | Description | Example |
password | A new password, if not given a random password will be used | newpassword |
Result Status Codes
Status Code | Description |
200 | OK, Success |
500 | Server error |
403 | Forbidden, demo server |
400 | Bad request or bad data |
Request URL
Post url = /passwd/
Full URL = https://your-host-name:5555/api/passwd/
Curl Code
#!/bin/bash
REQUEST_URL="/passwd/"
BASE_URL="https://your-host-name:5555/api/v1"
# Default base url
# BASE_URL="https://your-host-name:5555/api"
# Version specific base url
# BASE_URL="https://your-host-name:5555/api/v1"
API_URL="$BASE_URL$REQUEST_URL"
/usr/bin/curl -X POST $API_URL \
-d "apiuser=eenos_api" \
-d "apiauth=eenos123" \
-d "user=myclient" \
-d "password=newpassword"
Sample Output
{
"data" : "User password changed for myclient",
"info" : "Hosting account password changed successfully",
"status" : 200
}
Python Code
#!/usr/bin/python3
import requests
from pprint import pprint
# The API request url
request_url='/passwd/'
# The server api base url
base_url='https://your-host-name:5555/api'
# Default base url
# base_url='https://your-host-name:5555/api'
# Version specific base url
# base_url='https://your-host-name:5555/api/v1'
# The api url
api_ulr=base_url+request_url
# The data in dictionary format
data={
'apiuser': 'eenos_api',
'apiauth':'eenos123',
'domain':'myclientsite.com',
'user':'myclient',
}
try:
result=requests.post(api_ulr, data = data)
pprint(result.json())
except Exception as e:
pprint(str(e))
pass
PHP Code
<?php
// The API request url
$request_url='/passwd/';
// Your server API base url
$base_url='https://your-host-name:5555/api';
// Default base url
// $base_url='https://your-host-name:5555/api';
// Version specific base url
// $base_url='https://your-host-name:5555/api/v1';
// The FULL API URL
$api_url=$base_url.$request_url;
//The data you want to send via POST
$fields= [
'apiuser' => 'eenos_api',
'apiauth' => 'eenos123',
'user' => 'myclient',
];
//url-ify the data for the POST
$fields_string = http_build_query($fields);
//open connection
$ch = curl_init();
//set the url, number of POST vars, POST data
curl_setopt($ch,CURLOPT_URL, $api_url);
curl_setopt($ch,CURLOPT_POST, true);
curl_setopt($ch,CURLOPT_POSTFIELDS, $fields_string);
//So that curl_exec returns the contents of the cURL; rather than echoing it
curl_setopt($ch,CURLOPT_RETURNTRANSFER, true);
//execute post
$result = curl_exec($ch);
//Print the json result
echo json_encode(json_decode($result), JSON_PRETTY_PRINT);
?>