Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
gdevelop5:all-features:network [2018/10/15 23:37]
valiant_curiosity [Send a request to a server/API/web page]
gdevelop5:all-features:network [2019/05/20 00:02] (current)
piyushpalawat99
Line 9: Line 9:
 Games and applications work similarly to send or get data to a server: ​ Games and applications work similarly to send or get data to a server: ​
  
-  * they send a request to a specific address (also called an endpoint). Optionally the request can include parameters. +  * they send a request to a specific address (also called an endpoint). Optionallythe request can include parameters. 
-  * the server sends back a response. The set of all requests that is handled by a server is sometimes called an API.+  * the server sends back a response. The set of all requests that are handled by a server is sometimes called an API.
  
 In addition to the address and the parameters, HTTP requests can have a "​verb"​ associated as well.  Requests to get data or fetch a webpage are usually "​GET"​ requests. Requests to post data are usually "​POST"​ requests. In addition to the address and the parameters, HTTP requests can have a "​verb"​ associated as well.  Requests to get data or fetch a webpage are usually "​GET"​ requests. Requests to post data are usually "​POST"​ requests.
Line 20: Line 20:
 ## How to format the content ## How to format the content
  
-* For GET requests, parameters have to be send in the content in the format of a "query string":​+* For GET requests, parameters have to be sent in the content in the format of a "query string":​
 `parameter1=value1&​parameter2=value2&​parameter3=value3`... `parameter1=value1&​parameter2=value2&​parameter3=value3`...
  
Line 26: Line 26:
 `"​score="​ + VariableString(Score) + "&​playerName="​ + VariableString(Name)` `"​score="​ + VariableString(Score) + "&​playerName="​ + VariableString(Name)`
  
-* For POST requests, it depends on what is expected by the server, but most of the time the server ​expect ​JSON formatted text. +* For POST requests, it depends on what is expected by the server, but most of the time the server ​expects ​JSON formatted text. 
  
 You can either construct it yourself: You can either construct it yourself:
Line 35: Line 35:
 ### Variable to JSON ### Variable to JSON
  
-JSON is a text format that can be used to describe structure of data, containing number, strings, objects and arrays.+JSON is a text format that can be used to describe ​the structure of data, containing number, strings, objects and arrays.
 For example, an object containing the score and the name of a player would be: `{ "​name": ​ John, "​score":​ 45 }`. For example, an object containing the score and the name of a player would be: `{ "​name": ​ John, "​score":​ 45 }`.
  
Line 44: Line 44:
 <​note>​Learn more about Structures on the page about [[gdevelop5:​all-features:​variables|variables]].</​note>​ <​note>​Learn more about Structures on the page about [[gdevelop5:​all-features:​variables|variables]].</​note>​
  
-Structures are useful as they can store all the data concerning something, that can then be send to a server. To do this, you can convert the structure variable to JSON, using the expression called `ToJSON`. For example:+Structures are useful as they can store all the data concerning something, that can then be sent to a server. To do this, you can convert the structure variable to JSON, using the expression called `ToJSON`. For example:
  
-`ToJSON(Progress)`+``` 
 +ToJSON(Progress) 
 +```
  
-If Progress variable has a children "​Level"​ with value 4 and "​Score"​ with value 1500, the resulting JSON will be: `{"​Level":​ 4, "​Score":​ 1500}`.+If the Progress variable has a children "​Level"​ with value 4 and "​Score"​ with value 1500, the resulting JSON will be: `{"​Level":​ 4, "​Score":​ 1500}`.
  
-You can use it as the content of a request ​send to the server.+You can use it as the content of a request ​sent to the server.
  
 ### JSON to variable ### JSON to variable
Line 56: Line 58:
 You can go the other way, and convert JSON back to a variable. This is useful when you've received the answer from the server, which is also usually formatted in JSON. You can go the other way, and convert JSON back to a variable. This is useful when you've received the answer from the server, which is also usually formatted in JSON.
  
-Use the action "​**Convert JSON to a variable**"​ (or "​Convert JSON to global variable",​ or "​Convert JSON to object variable"​). Specify the JSON to be converted (which will be itself stored in a variable) and the variable where to store the resulting structure.+Use the action "​**Convert JSON to a variable**"​ (or "​Convert JSON to global variable",​ or "​Convert JSON to object variable"​). Specify the JSON to be converted (which will be itself stored in a variable) and the variablewhere you need to store the resulting structure.