Differences

This shows you the differences between two versions of the page.

--- manuals:vps:api [2017/03/27 07:37] – API v4.1 Aither
+++ manuals:vps:api [2019/05/17 14:03] – Aither
@@ Line 1: / Line 1: @@
 ====== API ======
-Our API is running at https://api.vpsfree.cz. The API can be used to perform most
+Our API is running at https://api.vpsfree.cz. The API can be used to perform
-actions, just like you can do from the web interface. The only things that the API currently doesn’t include
+any action that you can do in the web interface. In fact, the web interface
-are the management of user profiles (address, email, etc.) and data transfers.
+running at https://vpsadmin.vpsfree.cz uses the API and calls it for every
+action.
-In reality, the web interface running at https://vpsadmin.vpsfree.cz uses
-the API and calls it for every action.
 ===== API Documentation =====
 The API documentation, i.e. a list of objects, possible actions as well as input and output
-parameters can be found at https://api.vpsfree.cz/v4.1/.
+parameters can be found at https://api.vpsfree.cz/v5.0/.
 Even without logging in, you can see a list of all objects, i.e. even those that only
@@ Line 25: / Line 23: @@
   * Ruby - https://github.com/vpsfreecz/vpsfree-client
-  * PHP - https://github.com/vpsfreecz/haveapi-client-php
+  * PHP - https://github.com/vpsfreecz/haveapi/tree/master/clients/php
-  * JavaScript - https://github.com/vpsfreecz/haveapi-client-js
+  * JavaScript - https://github.com/vpsfreecz/haveapi/tree/master/clients/js
+  * Go - https://github.com/vpsfreecz/haveapi/tree/master/clients/go
   * The HaveAPI web interface - https://github.com/vpsfreecz/haveapi-webui
   * A file system based on FUSE - https://github.com/vpsfreecz/haveapi-fs
@@ Line 44: / Line 43: @@
 automatically, storing the password on the disk or copying it constantly is not a good idea.
-Another method is authentication using tokens. The way this method works is that the client first
+Another method is authentication using tokens. The way this method works is that
-requests a token to be created, one for which the client needs the name and password. As soon as the client receives
+the client first requests a token to be created, one for which the client needs
-the token, the name and password can be forgotten since it is the token that is then used for further authentication.
+the name, password and possibly TOTP. As soon as the client receives the token,
+the name and password can be forgotten since it is the token that is then used
+for further authentication.
 There can be several types of tokens with different lifetimes:
@@ Line 55: / Line 56: @@
   * permament - the token is valid permanently, or until it is deleted
-The type of token and time period by which its validity is extended is chosen by the client.
+The type of token and time period by which its validity is extended is chosen
+by the client.
 ===== CLI =====
@@ Line 165: / Line 167: @@
 Commands:
-vps remote_console VPS_ID            Open VPS remote console
+action_state wait <STATE ID>         Block until the action is finished
+vps remote_console VPS_ID            Open VPS remote console
+vps migrate_many VPS_ID...           Migrate multiple VPSes using a migration plan
+snapshot download [SNAPSHOT_ID]      Download a snapshot as an archive or a stream
+snapshot send SNAPSHOT_ID            Download a snapshot stream and write it on stdout
+backup dataset [DATASET_ID] FILESYSTEM Backup dataset locally
+backup vps [VPS_ID] FILESYSTEM       Backup VPS locally
+ip_traffic top                       Live IP traffic monitor
 Available resources:
-auth_token
 cluster
 cluster_resource
+cluster_resource_package
+cluster_resource_package.item
 dataset
 dataset.snapshot
 dataset.plan
+dataset.property_history
 dataset_plan
 dns_resolver
@@ Line 179: / Line 190: @@
 environment.config_chain
 environment.dataset_plan
+host_ip_address
 integrity_check
 integrity_fact
 integrity_object
 ip_address
+ip_traffic
+ip_traffic_monitor
+language
 location
 mail_log
@@ Line 188: / Line 203: @@
 mail_template
 mail_template.recipient
+mail_template.translation
+migration_plan
+migration_plan.vps_migration
+network
+network_interface
 node
+node.status
+object_history
 os_template
 pool
+session_token
 snapshot_download
+system_config
+transaction
 transaction_chain
-transaction_chain.transaction
 user
 user.environment_config
 user.cluster_resource
+user.public_key
+user.mail_role_recipient
+user.mail_template_recipient
 user.state_log
+user_cluster_resource_package
+user_cluster_resource_package.item
+user_namespace
+user_namespace_map
+user_namespace_map.entry
 user_session
 vps
@@ Line 203: / Line 235: @@
 vps.config
 vps.feature
-vps.ip_address
 vps.mount
+vps.outage_window
 vps.console_token
+vps.status
 vps_config
+monitored_event
+monitored_event.log
+outage
+outage.entity
+outage.handler
+outage_update
+user_outage
+vps_outage
+vps_outage_mount
+help_box
+news_log
+incoming_payment
+payment_stats
+user_account
+user_payment
+user_request
+user_request.registration
+user_request.change
+action_state
 </code>
@@ Line 234: / Line 286: @@
     -a, --auth METHOD                Authentication method
     -s, --save                       Save credentials to config file for later
-        --username USER              User name
+        --user USER                  User name
         --password PASSWORD          Password
         --token TOKEN                Token

Knowledge base

User Tools

Site Tools

Differences

Page Tools