http_client

Example

Here's an example of using the HTTPClient class. It's just a script, so it can be run by executing:

c:\godot> godot -s http_test.gd

It will connect and fetch a website.

extends SceneTree

# HTTPClient demo
# This simple class can do HTTP requests, it will not block but it needs to be polled

func _init():

	var err=0
	var http = HTTPClient.new() # Create the Client

	var err = http.connect("www.php.net",80) # Connect to host/port
	assert(err==OK) # Make sure connection was OK


	while( http.get_status()==HTTPClient.STATUS_CONNECTING or http.get_status()==HTTPClient.STATUS_RESOLVING):
                #Wait until resolved and connected
		http.poll()
		print("Connecting..")
		OS.delay_msec(500)

	assert( http.get_status() == HTTPClient.STATUS_CONNECTED ) # Could not connect

	# Some headers

	var headers=[
		"User-Agent: Pirulo/1.0 (Godot)",
		"Accept: */*"
	]

	err = http.request(HTTPClient.METHOD_GET,"/ChangeLog-5.php",headers) # Request a page from the site (this one was chunked..)

	assert( err == OK ) # Make sure all is OK

	while (http.get_status() == HTTPClient.STATUS_REQUESTING):
		# Keep polling until the request is going on
		http.poll()
		print("Requesting..")
		OS.delay_msec(500)


	assert( http.get_status() == HTTPClient.STATUS_BODY or http.get_status() == HTTPClient.STATUS_CONNECTED ) # Make sure request finished well.

	print("response? ",http.has_response()) # Site might not have a response.


	if (http.has_response()):
		#If there is a response..

		var headers = http.get_response_headers_as_dictionary() # Get response headers
		print("code: ",http.get_response_code()) # Show response code
		print("**headers:\n",headers) # Show headers

		#Getting the HTTP Body

		if (http.is_response_chunked()):
			#Does it use chunks?
			print("Respose is Chunked!")
		else:
			#Or just plain Content-Length
			var bl = http.get_response_body_length()
			print("Response Length: ",bl)

		#This method works for both anyway

		var rb = RawArray() #array that will hold the data

		while(http.get_status()==HTTPClient.STATUS_BODY):
			#While there is body left to be read
			http.poll()
			var chunk = http.read_response_body_chunk() # Get a chunk
			if (chunk.size()==0):
				#got nothing, wait for buffers to fill a bit
				OS.delay_usec(1000)
			else:
				rb = rb + chunk # append to read bufer


		#done!

		print("bytes got: ",rb.size())
		var text = rb.get_string_from_ascii()
		print("Text: ",text)

		
	quit()		
	
	

(c) Juan Linietsky, Ariel Manzur, Distributed under the terms of the CC By license.