Requesting the API

The Nationstates package includes a simple interface for developers.

For example, for the following code:

>>> import nationstates as ns
>>> api = ns.Api(UniqueAndDescriptiveUserAgent)
>>> nation = api.get_nation("The United Island Tribes")

The Api object centralizes API use. It preforms the necessary handeling of Nationstates objects to create objects that share certain attributes (Such as requests’s Session object). The :method:`.get_nation` method creates a Nationstates object for the ‘The United Island Tribes’.