NationStates API (nationdata/regiondata)

[Praeceps]

Request

Would it be possible to add a Nation API shard that returns information about the nation's card deck?

For example, the shard could return the nation's bank, and a list of cards the nation has, where for each card it reports its name, rarity, and season.

Thanks a lot!

I think this is a great idea!

I know a few regions discussing ways to use cards to increase integration and activity. Having an API shard would present us with more options to build on the mini-game.

[Vulturret]

Request

I would like to request that the private API commands available (currently only pertaining or usable for answering issues) be expanded, at least to posting and editing dispatches. This would be highly beneficial to those of less... technically inclined, to put it nicely. This, along with a few other items (which would all also be beneficial, I'm sure) was requested by HMS Unicorn back in 2016, but was never implemented or formally addressed.

Being able to edit dispatches without having to make complicated scripts with storing login cookies and the like would be highly beneficial to players who have to maintain lots of dispatches that need to change frequently (and en masse), such as the integration dispatch or list of current officials. This would also benefit those who already do dispatches via HTML, as the scripts could go faster and not have to scrape the page.

[violet] has also said in the past that these commands will be added on a "squeaky wheel" basis, and I'm not sure if this has reached this stage yet, but it seems to have been requested several times, so coming close, for sure.

I should be grateful if this is considered. Thanks!

EDIT: Fixed erroneous link.

[Imperium Anglorum]

When the API gives an option (known in the GA as Strength, Area of Effect; SC as nominee, target), sometimes it gives 0. What is this? And it occurs, I believe, in area of effect categories.

[Agadar]

Is there a way to get the number of RMB pages? There is no available property for it on the Region resource, and it can't be derived from the Messages property.

[Imperium Anglorum]

Also, can we get legality information from the WA proposals API?

[Cardashian]

Request

Would it be possible to add a Nation API shard that returns information about the nation's card deck?

For example, the shard could return the nation's bank, and a list of cards the nation has, where for each card it reports its name, rarity, and season.

Thanks a lot!

So much this. At the moment, when I want to see if I have cards from a certain region, I have to go through all my cards, open them, etc.

Also, I'd like a way to know which card is in most collections. But that is more the statistic geek in me

-Blaat on a puppet

[Darcania]

Request

Would it be possible to add a Nation API shard that returns information about the nation's card deck?

For example, the shard could return the nation's bank, and a list of cards the nation has, where for each card it reports its name, rarity, and season.

Thanks a lot!

I would definitely love this - it would make a most lovely addition to any Discord server if I could code the bots to give info about a nation's card deck, as well as info on the nation's card itself.

[Leppikania]

Is there an XML schema for the API anywhere?

[Trotterdam]

As far as I know, the only way to tell the format of the API results is to just test it and see what you get. The format is pretty rigid, so once you've seen an example or two you should know what to expect.

That's inconvenient for the private commands, since they're not something you can just test without side effects.

[Darcania]

That's inconvenient for the private commands, since they're not something you can just test without side effects.

I'd recommend the use of a test puppet nation for testing private shards.

[Karteria]

Not sure if I had to make a separate topic for this question – but if my region already has an API Client Key for recruitment, can I get a new one for WA Campaigning, or do I have to use the same one?

Probably didn't read close enough.

[Frisbeeteria]

if my region already has an API Client Key for recruitment, can I get a new one for WA Campaigning, or do I have to use the same one?

Use the same one.

Only one key can be issued per region. That's why people who want to campaign from large regions like GCRs get asked to use a puppet to found a region just for the key.

[Caelapes]

Crossposting this in the appropriate thread:

Is there any way that these silent DEATs could show in the API Happenings but still be hidden from the Activity page?

[The Blaatschapen]

Crossposting this in the appropriate thread:

Is there any way that these silent DEATs could show in the API Happenings but still be hidden from the Activity page?

What's your use case?

[Caelapes]

Crossposting this in the appropriate thread:

What's your use case?

I'm also more broadly in favor of a flag in Happenings that shows that a nation CTEing was from a DEAT (which could be used to separate DEATs that are handed down during update from update time-signifying CTEs), but the use case here is to properly update a nation database when nations CTE instead of having to compare against the next daily dump, which is imperfect.

[Frisbeeteria]

The majority of DEATs are new nations with offensive or abusive nation names. Next most common is DOS puppets. We don't really want to publish info on either. Do you really need to track "NS_Mods_Suck_Donkey_Dick" and all the variations? I'm seeing more negatives than positives in including that data in the dumps.

[Caelapes]

The majority of DEATs are new nations with offensive or abusive nation names. Next most common is DOS puppets. We don't really want to publish info on either. Do you really need to track "NS_Mods_Suck_Donkey_Dick" and all the variations? I'm seeing more negatives than positives in including that data in the dumps.

I would argue that the API (again, I'm not advocating for this being included in the game-side Activity page) isn't really "publishing info" on DEATed nations with offensive names any more than the Boneyard is - perhaps less so, given how few players use the API compared to the Boneyard.

And this isn't about tracking which nations are deleted by moderators so much as it is being able to filter out DEATs and also be able to update a nation table to remove inactive nations - which could be done by comparing against data dumps, but that's not always fully perfect, either.

[The Northern Light]

Request

Would it be possible to add a Nation API shard that returns information about the nation's card deck?

For example, the shard could return the nation's bank, and a list of cards the nation has, where for each card it reports its name, rarity, and season.

Thanks a lot!

Hi,

I'd like to bump this request. I feel like having this API shard would greatly enhance the cards game, by allowing regions to run their own regional showcases, contests, and so on. I know for a fact that TNP has been discussing a large number of cards-related events and infrastructure, which would greatly benefit from (or only be possible if) this shard being added to the API. I assume we are not the only region to be considering this.

Thanks again for the consideration.

[Ever-Wandering Souls]

Request

Would it be possible to add a Nation API shard that returns information about the nation's card deck?

For example, the shard could return the nation's bank, and a list of cards the nation has, where for each card it reports its name, rarity, and season.

Thanks a lot!

Hi,

I'd like to bump this request. I feel like having this API shard would greatly enhance the cards game, by allowing regions to run their own regional showcases, contests, and so on. I know for a fact that TNP has been discussing a large number of cards-related events and infrastructure, which would greatly benefit from (or only be possible if) this shard being added to the API. I assume we are not the only region to be considering this.

Thanks again for the consideration.

R3N builds amazing things when enabled to. Support.

[The Northern Light]

More generally, it would be amazing if there were some more comprehensive API support for cards. I imagine that this could be setup as a separate category, or part of the "World" category.

In addition to the above mentioned call producing information about a nation's deck, here are a few more things I would love to be able to use:

1) q=card;cardid=XXXX: This shard can be used to pull basic data about a specific card, e.g., rarity, market value, number of owners, etc. Additional options can be used to get specific bits of information, e.g., owners, transactions, and finds.

2) q=trades: It would return information about completed trades. This could work similar to the happenings stream, allowing users to set time ranges using timestamps or trade IDs.

3) q=cards: It would return a list of the top-valued cards.

4) q=decks: It would return a list of the top-valued decks.

As I stated in my previous post(s), this kind of API functionality could greatly facilitate regional programs. Regions, or groups of regions, could start setting up their own micro-markets, internal rankings, competitions, and so on.

Additionally, the above would allow those of us interested in the more quantitative side of things to start compiling and publishing statistics about the status of both regional and global markets: What is the total amount of legendaries available? How are average prices per rarity changing over time? What is the daily volume of transactions? How many unique nations are taking part? And so on.

[Leppikania]

Is there a way to get an autologin key without using the X-Password header? Like, say, a particular hash function?

[The Northern Light]

Would it be possible to revisit this suggestion?

It was brought up here, and several players mentioned they would benefit from the addition. But the discussion soon digressed to including LASTUPDATE in the dumps.

It'd save me a few dozens of thousands of API calls per day, and I imagine it's the same for many other players.

I'd like to bump this request. Adding the SPDR metric in the national dumps would be enormously useful for a large swath of (at least) gameplayers, who frequently need to comb through influence statistics for various purposes (regional security, R/D, WA and endotarting promotion, etc.).

Given that compiling influence statistics often requires fetching the SPDR of entire region populations one nation at a time, it would save both the players and the server a considerable amount of API bandwidth.

The nation dumps already include a few other censuses in various forms, namely CENSUSIDs 0, 1, 2, 3, and 49 (there is also a "PUBLICSECTOR" field for which I could not determine whether it corresponds to a CENSUSID). I understand that at least the first four are "special" censuses (respectively: the three censuses that determine a nation's category, and population). I'd argue that SPDR is also special, given its role in determining the feasibility/outcome of many gameplay actions. Therefore, it should be included in the nation dumps, just as CENSUSIDs 0-3 are.

Hi,

Is there any chance that this request could be considered?

[Bluelight-R006]

I’m new to API, and I’m curious, because we can’t use a script to send telegrams from the regular telegrams page, then where do we send them from?

[Phydios]

I’m new to API, and I’m curious, because we can’t use a script to send telegrams from the regular telegrams page, then where do we send them from?

You use the Telegram API, along with a computer program to call the API.

[Radical Republic]

I'm sure this has already been asked on here but I don't have the time to read trough 77 pages of forums. My api isn't sending the recruitment telegrams. I'm using the key that I got from the previous user and the test telegram worked. Help?