Získejte zdarma licenci (cFosSpeed) za pomoc s 10 a více opravami našeho webového překladu
Některé texty jsou generovány strojovým překladem. Pomozte nám tyto texty vylepšit. Klepnutím na tlačítko spustíte režim revize.
cFosSpeed internal webserver API
To access the webserver in cFosSpeed use a URL beginning with:
http://localhost:1487/cfosspeed/
1487 is the default port number. You can specify a different port number in
the file c:\programdata\cfos\cfosspeed\global.ini, section [All], key
"server_port".
Parameters are specified as in normal GET requests by appending a "&" or "?",
then the parameter name, then "=" and lastly a UriComponentEncoded value to
the URL, e.g.,
http://localhost:1487/cfosspeed/util?f=test¶m1=val1
The following functions are available:
Get list of current connections
-------------------------------
http://localhost:1487/cfosspeed/util?f=current_connections
Parameters:
from= default 1
to= default 0
mode=m default 0
m == 0 individual connections
m == 1 group connections with same program name together
m == 2 group connections with same L7 protocol together
m == 3 group connections with same program name / L7 protocol pair together
instead of mode you can also specify one or more filters
con_id only return stats about one connection with this con_id
program only return stats about connections with a certain program
prot only return stats about connections with a certain L7 protocol
Return:
JSON array of connections
each connection has the following properties:
rip remote IP address
lip local IP address
rp remote port
lp local port
pr L7 protocol
tcp true if TCP, false otherwise
key unique connection id (con_id)
rx total number of bytes received
tx total number of bytes sent
rx_cps current speed in bytes/s, receive
tx_cps current speed in bytes/s, send
rx_spd current speed in 0..100 percent, receive
tx_spd current speed in 0..100 percent, send
stm connection start time as unix time stamp in seconds
rtt round-trip-time in milliseconds
pg program name (exe)
l7d L7 protocol data
c prio class
sc saved prio class (if c != sc) priority was changed manually
h host name
n number of connections if grouped, otherwise 1
mrx max receive speed in bytes/sec
mtx max send speed in bytes/sec
p current cFosSpeed port number
rxh array of rx_spd values of the last "from" to "to" seconds
txh array of tx_spd values of the last "from" to "to" seconds
a value of -1 in the array means: connection not available
Get status infos for all open ports
-----------------------------------
http://localhost:1487/cfosspeed/util?f=stat_infos
Parameters:
d= default "text/javascript"
Return:
JSON array of status info per open port, see
https://www.cfos.de/en/skin/skin-reference.htm
for details.
Prepare usage data
------------------
http://localhost:1487/cfosspeed/util?f=read_bdata
Prepare all program and protcol usage data for
evaluation for usage graph display. Also collect list
of used programs / protocols for the last 12 months.
Return:
"ok"
Recommend WiFi channels
-----------------------
http://localhost:1487/cfosspeed/util?f=wifi_channel_recommendation
Return:
space-separated list of WiFi channel numbers, least used first,
most used last.
Get WiFi frequence usage
----------------------------------
http://localhost:1487/cfosspeed/util?f=wifi_freq_usage
Return:
JSON array of entries with name, center frequency in kHz and signal strength (from 0 to 100).
Get names of all RAS / Dial-Up Networking entries
-------------------------------------------------
http://localhost:1487/cfosspeed/util?f=ras_entry_names
Return:
JSON array with names of all RAS entries
Get names of all network entries cFosSpeed is bound to
------------------------------------------------------
http://localhost:1487/cfosspeed/util?f=get_network_entries
Return:
JSON array with names of all entries with the following members:
name friendly name of the adapter
entry_name name of the entry for traffic shaping settings
section section name for traffic shaping settings
st 0 = traffic shaping disabled, 2 = traffic shaping enabled
is_wan true = dial-up connection, false = LAN connection
mac MAC address of the adapter if LAN connection
ip Router IP address if LAN connection
Set parameters of network entry
-------------------------------
http://localhost:1487/cfosspeed/util?f=set_network_entry
Parameters:
is_wan= default 0, n = 1 means WAN / dial-up adapter
st= default , if not empty: n = 0 disable traffic shaping
n = 2, enable traffic shaping
entry_name as returned by 'get_network_entries' for this adapter,
must be specified if is not empty
mac as returned by 'get_network_entries' for this adapter,
must be specified if is not empty
cooperative 1 = cooperative Traffic Shaping, 0 = non-cooperative
net_talk 1 = broadcast traffic statistic to other cFosSpeed in your LAN, 0 = disabled
budget 1-10, count traffic to Budget 1-10, 0 = don't count
medium set traffic shaping medium
0=adaptive, 1 = DSL PPPoE, 2 = DSL PPPoE VC MUX, 3 = DSL PPTP, 4 = cable
5 = ISDN, 6 = DSL PPPoA LLC, 7 = IP over AAL5, 8 = bridged over AAL5,
9 = frame_count, 10 = cable mixed, 11 = 3G/4G/5G, 12 = VDSL
see output of the SPD set medium /? for a list of supported mediums
use_variance 1 = take ping variance into account, 0 = use fixed ping values
Restore default prioritization settings
---------------------------------------
http://localhost:1487/cfosspeed/util?f=restore_defaults
Parameters:
d= type = 'progs', restore program priorities,
type = 'prots', restore L7 protocol priorities
Get directory of cFosSpeed global data
--------------------------------------
http://localhost:1487/cfosspeed/util?f=program_data_dir
Return:
The location of the cFosSpeed program data directory
Get/set a named cFosSpeed parameter
-----------------------------------
http://localhost:1487/cfosspeed/util?f=param
Parameters:
d= default empty, a section name in the file global.ini
k= name of the key to get or set
v= if present, the key will be set to
Return:
The value of the key
Set the priority of a program or protocol (permanently)
-------------------------------------------------------
http://localhost:1487/cfosspeed/util?f=set_item_prio
Parameters:
d= 'prog' for programs, 'prot' for protocols
k= exe filename for programs, l7 name for protocols
v= prio of the item: 'lowest', 'low', 'normal', 'high', 'higher'
filter= filter selection in the dialog, e.g., 'multimedia'
desc= is a description, in case the item is created (instead of
just modified)
flush=1 if present, the modfication is written to disk immediately,
otherwise it might be delayed
Get the list of priorities
--------------------------
http://localhost:1487/cfosspeed/util?f=get_prio_list
Parameters:
d= 'prog' for programs, 'prot' for protocols
filter= filter selection in the dialog, e.g., 'multimedia'
used_only=1 if present only programs used in the last 12 months are
returned
Return:
JSON array of priority entries. Each entry has the following members:
exe the exe filename of the program or the L7-protocol name
c the current priority
u the priority which was set by the user
s the priority in the default settings
f the filter of the current item
d the description
Get the list of used programs or protocols
------------------------------------------
http://localhost:1487/cfosspeed/util?f=get_used
Parameters:
d= 'prog' for programs, 'prot' for protocols
Return:
JSON array of programs (exe filenames) or L7 protocol names
Get the settings of a budget
----------------------------
http://localhost:1487/cfosspeed/util?f=get_budget
Parameters:
d= n = 1..10 to select one of the 10 budgets
Return:
A budget object with the following members:
time_used string with the time used in min:secs
volume_used volume used in bytes
hard_limit 1 if the limit is enforced, 0 if not
time_limit time limit in secs
volume_limit numeric value of the volume limit
volume_limit_unit 0=kilobytes, 1=megabytes, 2=gigabytes
reset_day 1..31, the day when the used time and volume are reset
to 0
Set the parameters of a budget
------------------------------
http://localhost:1487/cfosspeed/util?f=set_budget
Parameters:
d= n = 1..10 to select one of the 10 budgets
hard_limit= n = 1 enforce limit, 0 don't
time_limit= time limit in seconds
volume_limit= numeric value of the volume limit
volume_limit_unit= 0=kilobytes, 1=megabytes, 2=gigabytes
reset_day= 1..31 day when the used values of the budget are
reset
Get historical usage data
-------------------------
http://localhost:1487/cfosspeed/util?f=set_graph_data
Parameters:
type= 1 = totals, 2 = budgets, 3 = protocols, 4 = programs
sel= s selects which item in the type
Return:
JSON object with the following members:
month array of the numbers of the last 12 months
year array of the years of the last 12 months
mday array of the number of days of the last 12 months
rx: array of 12 arrays with the number of received bytes for each of the
last 12 months
tx: array of 12 arrays with the number of sent bytes for each of the last
12 months
Get receive/send stats for an item type
---------------------------------------
http://localhost:1487/cfosspeed/util?f=set_graph_data
Parameters:
type= 1 = totals, 2 = budgets, 3 = protocols, 4 = programs
range= get usage data for the last days
Return:
JSON array of objects with the following members:
n name of the item
desc description of the item
rx number of received bytes in the last days
tx number of received bytes in the last days
Activate IP blocker
-------------------
http://localhost:1487/cfosspeed/util?f=ip_blocker
Parameters:
d= 1 = activate, 0 = deactivate
Send an SPD command to the driver
---------------------------------
http://localhost:1487/cfosspeed/spd?cmd
is the command string sent to the driver.
Return:
Text output of the driver.
Get the icon of the currently running exe
-----------------------------------------
http://localhost:1487/cfosspeed/stats/icon
Parameters:
exe= exe filename
small=1 if present, retrieve the small icon, otherwise the normal icon.
Return:
A PNG image with the icon or a default image, if an icon is not available.
Jak používat API webového serveru cFosSpeed pro získání statistik Traffic Shaping, vytvoření vlastních konfiguračních dialogů nebo aplikací stavových informací.