True Random Number Service

Automated Clients

RANDOM.ORG is a true random number service that generates randomness via atmospheric noise. This page discusses how to use automated clients to interface to the service.

You can write your own client to access the RANDOM.ORG services or you can download one of the clients listed below. If you have written a client that you don't mind other people using, email it to me (preferably with instructions on how to use it), and I will put it on this page. You will of course get full credit.

Important Guidelines

If you use an automated client, please make sure it observes the following guidelines:

Do not hit the server with multithreaded clients. Use a single thread to perform successive requests.
If you need many numbers, issue requests that fetch the numbers in blocks as large as possible. Please do not issue a request for every single number, unless you only need one.
Use a long timeout value for your requests. Unless you have used up your quota, the RANDOM.ORG server actually tries to satisfy all requests, so if you use a short timeout value, your request will be abandoned halfways and the numbers discarded. This increases load on the server. Allow at least a couple of minutes for the server to complete your request.
Configure your client to examine your remaining allowance using the Quota Check interface. If your allowance is negative, your client should back off and not issue any requests for numbers. You can configure your client to check its quota again after ten minutes. If your quota has become positive, you can start issuing requests again.
Configure your client to supply your email address in the User-Agent field of the request. That way, I can drop you a line if your client is causing trouble.

As always, feel free to email me if you have questions!

HTTP Clients

These clients access RANDOM.ORG via the HTTP Interface.

Ruby Client
Author: Ben Aroia
Date: 2008-04-03
Download: random-get.rb
HTTP GET code for RANDOM.ORG that retrieves random numbers and outputs them in the order they appear. It is/will be possible to allow outputing in several different formats. (i.e. print them/use them one by one, save them to a file in several formats, command line options, etc) This is a basic version that will allow you to use the Integer Generator and output in a single line at the terminal.

SOAP Clients

Unfortunately, the SOAP interface is disabled at the moment.

CORBA Clients

Unfortunately, the CORBA interface is disabled at the moment.