This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | Next revision Both sides next revision | ||
api:internet [2019/06/12 05:26] jacky_wang [Internet API] |
api:internet [2019/06/15 09:24] payonel |
||
---|---|---|---|
Line 3: | Line 3: | ||
This library wraps functionality of Internet cards. Also see the [[component:internet|Internet Component]] for more low level functionality (such as querying availability of HTTP and TCP functionality). | This library wraps functionality of Internet cards. Also see the [[component:internet|Internet Component]] for more low level functionality (such as querying availability of HTTP and TCP functionality). | ||
- | - `internet.request(url: string[, data: string or table[, headers: table]]): function` | + | - `internet.request(url: string[, data: string or table[, headers: table[, method: string]]]): function` |
- | Sends an HTTP request to the specified URL, with the specified POST data, if any. If no data is specified, a GET request will be made. The POST data can be in one of two formats: if it's a string, it will be sent as-is. If it's a table, it will be converted to a string by assuming that each key is the name of a POST variable, and it's associated value is the value for that variable. So, for example: | + | Sends an HTTP request to the specified URL, with the specified POST data, if any. If no data is specified, a GET request will be made. The POST data can be in one of two formats: if it's a string, it will be sent as-is. If it's a table, it will be converted to a string by assuming that each key is the name of a POST variable, and it's associated value is the value for that variable. **method** can be explicitly specified to values such as GET, POST, or PUT. Some examples: |
`internet.request(url, {some = "variable", another = 1})` | `internet.request(url, {some = "variable", another = 1})` | ||
Will send `some=variable&another=1`. | Will send `some=variable&another=1`. | ||
Line 11: | Line 11: | ||
Note that **this method ALSO support HTTPS**. So simply use | Note that **this method ALSO support HTTPS**. So simply use | ||
`internet.request("https://example.com")` to send a request through HTTPS. | `internet.request("https://example.com")` to send a request through HTTPS. | ||
+ | | ||
+ | Example specifying PUT: | ||
+ | `internet.request("https://example.com", "put data", {}, "PUT")` to send a request through HTTPS. | ||
- `internet.socket(address:string[, port:number]):table` | - `internet.socket(address:string[, port:number]):table` | ||
Line 76: | Line 79: | ||
----------- | ----------- | ||
{{page>api:contents&noheader&noeditbutton&nouser&nofooter}} | {{page>api:contents&noheader&noeditbutton&nouser&nofooter}} | ||
+ |