NationStates API (nationdata/regiondata)

[Rich and Corporations]

@Rich and Corporations: you're passing strings, not constants. Get rid of the apostrophes. Also, that's more of a general PHP question, and not an NS API question...

I'm sorry. I do make php questions from time to time here anyway though.

[Tribes Republic]

Does the NS API should work with Microsoft's Visual Studio 2013, because I have all three Express versions Web, Windows, and Desktop

[Rich and Corporations]

Does the NS API should work with Microsoft's Visual Studio 2013, because I have all three Express versions Web, Windows, and Desktop

Yes, I believe you can make a web request using Visual Studio.

[Tribes Republic]

Does the NS API should work with Microsoft's Visual Studio 2013, because I have all three Express versions Web, Windows, and Desktop

Yes, I believe you can make a web request using Visual Studio.

I may have to use VS for Web 2013, but it uses Microsoft Azure so I may have to write a workaround for that

[Tribes Republic]

Code: Select all


            // Uncomment the following lines to enable logging in with third party login providers
            //app.UseMicrosoftAccountAuthentication(
            //    clientId: "",
            //    clientSecret: "");

            //app.UseTwitterAuthentication(
            //    consumerKey: "",
            //    consumerSecret: "");

            //app.UseFacebookAuthentication(
            //    appId: "",
            //    appSecret: "");

            //app.UseGoogleAuthentication(new GoogleOAuth2AuthenticationOptions()
            //{
            //    ClientId = "",
            //    ClientSecret = ""
            //});
        }
    }
}


where would the NS authentication go this is Visual C# 2013, would I be able to just change one of the ones for Google, Facebook, or Twitter and there shouldn't be a problem

[Southern Ageena]

Any chance we could get a nation's nation analysis values? For example obesity, niceness etc.Never mind, I'm an idiot.

[Unibot III]

I don't see a shard for poll data -- that would be helpful for us to track the progression of polls.

[Rich and Corporations]

I don't see a shard for poll data -- that would be helpful for us to track the progression of polls.

I second this.

[Upska]

Why does the legislation shard only contain the four last legislations if it is possible to have five new ones in one day by saving up your issues? This would mean that some nations would have one legislation missing in the API every 2-3 days.

[Lordieth]

I'm really rusty on the API, but I want to write a new recruitment script. Has the process changed much since the new system was created with TG templates the like? I've also lost my API key. Can I just send a GHR to get that?

One specific question; when sending a recruitment TG, how often until we can TG that nation again? I'm going to record TGs sent in a DB of sorts with timestamps, and I'll want to prune it periodically, as I'll be constantly querying it to ensure I don't TG the same nation more than once when I poll the API for new nations.

[[violet]]

Why does the legislation shard only contain the four last legislations if it is possible to have five new ones in one day by saving up your issues?

Those two numbers are unrelated. You can have up to 5 unaddressed issues and your nation can have up to 4 descriptors generated by passed legislation.

[[violet]]

I don't see a shard for poll data -- that would be helpful for us to track the progression of polls.

I second this.

Poll data is now available via Region and World shards!

Documentation
Region shard example
World shard example

[[violet]]

One specific question; when sending a recruitment TG, how often until we can TG that nation again? I'm going to record TGs sent in a DB of sorts with timestamps, and I'll want to prune it periodically, as I'll be constantly querying it to ensure I don't TG the same nation more than once when I poll the API for new nations.

It's 28 days until you can recruit the same nation for the same region. The system will automatically block any more recruitment TGs within that window as "Previous Recruitment Too Recent."

For other API details take a look here.

[Unibot III]

I second this.

Poll data is now available via Region and World shards!

Documentation
Region shard example
World shard example

Thanks so much [violet]!

[Larthinian Fast Response Elite Police]

Excuse me, how am I supposed to use API?

[HMS Unicorn]

Would it be possible to add a shard for the nation API producing the list of all factbooks/dispatches that nation has published?

Also, would it be possible to add an API call (not sure where this would go) for fetching a factbook/dispatch by its ID?

Currently, I believe (though I may always be mistaken) that both of these actions can only be done through HTML scraping, which is really inefficient if you need to compile lists of dispatches from multiple nations.

I am still interested in this. Would it be possible to add these shards to the nation API?

[Eluvatar]

So, my adventures in encodings have a sequel, the lovely motto changes of Battle Islands

See here:
It wouldn't be visible in this forum if I copied it over, but between the "Fuc" and the "kers" there is a unicode-encoded U+009d character (0xc29d), of which the 0x9d byte is not valid ISO-8859-1.

This of course means that my earlier approach to getting API results safely parsed, based on earlier interesting results, of throwing them into the windows-1252 (ISO-8859-1) decoder, won't work

In unicode, U+009d means <control> (as in the Ctrl key).

Two questions:

1. Should mottos with control characters in them be allowed?
2. Is it now safe for me to expect the NS API to return valid UTF+8 (and not ISO-8859-1 which isn't valid UTF+8, as would sometimes happen before)?

[[violet]]

Two questions:

1. Should mottos with control characters in them be allowed?
2. Is it now safe for me to expect the NS API to return valid UTF+8 (and not ISO-8859-1 which isn't valid UTF+8, as would sometimes happen before)?

1. No! As of now, fields cannot contain Unicode Control Characters. Thanks for pointing this out.

2. I believe so, yes. At least, it is right of you to expect valid UTF-8. If you see otherwise, please let me know.

[[violet]]

Would it be possible to add a shard for the nation API producing the list of all factbooks/dispatches that nation has published?

I've added this one: see the documentation for some examples, but there are "factbooks" and "dispatches" for the number of each written by that nation, and "factbooklist" and "dispatchlist" for a summary of them.

Also, would it be possible to add an API call (not sure where this would go) for fetching a factbook/dispatch by its ID?

Yes, it would. It can be a World API shard. I presume you want the full text?

[Eluvatar]

Would it be possible to add a shard for the nation API producing the list of all factbooks/dispatches that nation has published?

I've added this one: see the documentation for some examples, but there are "factbooks" and "dispatches" for the number of each written by that nation, and "factbooklist" and "dispatchlist" for a summary of them.

Also, would it be possible to add an API call (not sure where this would go) for fetching a factbook/dispatch by its ID?

Yes, it would. It can be a World API shard. I presume you want the full text?

I'm not certain about r3n (HMS Unicorn) but I know I would love a factbook API that gave the 'raw' text

[[violet]]

I'm not certain about r3n (HMS Unicorn) but I know I would love a factbook API that gave the 'raw' text

Added new shards "dispatch" and "dispatchlist": the first one allows looking up full dispatch text by ID, and the second one provides a list of dispatches in a particular category, sorted in a particular way. More info in the doc!

[Eluvatar]

I'm not certain about r3n (HMS Unicorn) but I know I would love a factbook API that gave the 'raw' text

Added new shards "dispatch" and "dispatchlist": the first one allows looking up full dispatch text by ID, and the second one provides a list of dispatches in a particular category, sorted in a particular way. More info in the doc!

[HMS Unicorn]

These are great, thanks a lot!

[Railana]

I've created a .NET interface for the NationStates API, if anyone's interested.

[Babylatia]

When I use the https://www.nationstates.net/cgi-bin/api.cgi?nation=Babylatia with PHP, I get an error with the '&' in 'Law & Order' because it is not '&amp;'.