Dell N3200-ON Networking N-Series Switches RESTful API User Guide version 6.8. - Page 9

RESTful OpEN API Overview, Base URL

Page 9 highlights

2 RESTful OpEN API Overview The Dell Networking RESTful API allows you to configure various operational parameters and attributes, including selected protocols on the target switch. Since the API is based on REST principles, it is very easy to write and test applications. You can use your browser to test URLs, and you can use pretty much any HTTP client in any programming language to interact with the API. Please note, although Internet-based browsers can issue requests, the intended use of this REST API is a programming interface. Most modern programming languages provide support for constructing and parsing JSON, as well as issuing HTTP requests. Examples include Python's 'requests' and 'json' modules, and the Java classes in the org.apache.http and org.json.simple namespaces. The REST of the API examples in this document demonstrate the use of the libcurl library using the cURL command-line tool found at http://curl.haxx.se/. Base URL All URL references in this documentation have the following base: serveraddress:RESTful_port/open/version, where: • The server-address is the IP address or host name of the target switch. • RESTful_port is the configured Layer 4 port number in the range 1025 to 65535 for RESTful connection. The default RESTful port is 8080. Following the server-address: • RESTful_port is the open resource, which is used to redirect the request to the Dell Networking N-Series RESTful APIs for Dell OpEN. • Versioning is mandatory and is part of the URL. The version is denoted by using the letter v followed by a single version number. For example, http://10.10.10.1:8080/open/v1/ RESTful OpEN API Overview 9

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217

RESTful OpEN API Overview
9
2
RESTful OpEN API Overview
The Dell Networking RESTful API allows you to configure various
operational parameters and attributes, including selected protocols on the
target switch. Since the API is based on REST principles, it is very easy to
write and test applications. You can use your browser to test URLs, and you
can use pretty much any HTTP client in any programming language to
interact with the API.
Please note, although Internet-based browsers can issue requests, the
intended use of this REST API is a programming interface. Most modern
programming languages provide support for constructing and parsing JSON,
as well as issuing HTTP requests. Examples include Python's 'requests' and
'json' modules, and the Java classes in the org.apache.http and org.json.simple
namespaces. The REST of the API examples in this document demonstrate
the use of the
libcurl
library using the cURL command-line tool found at
.
Base URL
All URL references in this documentation have the following base:
serveraddress:RESTful_port/open/version
, where:
The server-address is the IP address or host name of the target switch.
RESTful_port is the configured Layer 4 port number in the range 1025 to
65535 for RESTful connection. The default RESTful port is 8080.
Following the server-address:
RESTful_port is the
open
resource, which is used to redirect the request
to the Dell Networking N
-
Series RESTful APIs for Dell OpEN.
Versioning is mandatory and is part of the URL. The version is denoted by
using the letter
v
followed by a single version number.
For example,