NationStates API (nationdata/regiondata)

[[violet]]

The MEMBERLOG shard of the World Assembly API seems to have stopped updating.

Thanks, yes, it broke. Since Happenings, "memberlog" has been a standalone and fully redundant system, so I'm not going to fix it. For now I've made it return the same info as "q=happenings;filter=member" and in the future I'll remove it altogether.

[[violet]]

Bug report: for the current SC resolution, the "REPEALS_COUNCILD" field isn't being returned. It should return "207" -- pointing to the SC resolution being repealed.

The same thing seems to be happening to the current GA resolution -- REPEALS_COUNCILD isn't included in the XML returned (REPEALS_COUNCILD should be 385).

Neither of the resolutions at vote are repeals at the moment so I can't see the problem. Was there a REPEALS_COUNCILD field (missing an "I")?

[Greater Tern]

Neither of the resolutions at vote are repeals at the moment so I can't see the problem.

The active resolutions at the time of posting were repeal resolutions, namely SC #208 and GA #387 respectively. Looks like the API is properly returning it on old resolutions as "REPEALS_COUNCILID", but it wasn't showing up for active resolutions.

Was there a REPEALS_COUNCILD field (missing an "I")?

Yep, that's how it was spelled when it was added:

Added these to repeals: <REPEALS_COUNCILD> and <REPEALS_RESID>.

You can see it in SC #204, but looking at SC #208 above it's now spelled "REPEALS_COUNCILID". Would it be possible to make this consistent?

[[violet]]

Ah ok. A typo crept in there. It's supposed to be REPEALS_COUNCILID. I'll sync those up.

[Greater Tern]

Ah ok. A typo crept in there. It's supposed to be REPEALS_COUNCILID. I'll sync those up.

Thanks [violet]! One more thing -- not sure if it's intentional, but it seems that the values returned by REPEALS_COUNCILID are off by 1. (I'm guessing the resolutions are zero-indexed?)

[Melorian Republic]

Just curious: are there any JavaScript NS API parsers out there? I only seem to see Java and Python and others.

[Auralia]

Just curious: are there any JavaScript NS API parsers out there? I only seem to see Java and Python and others.

Yes!

[Melorian Republic]

Just curious: are there any JavaScript NS API parsers out there? I only seem to see Java and Python and others.

Yes!

Thank you! This is what I needed.

[Greater Tern]

Hey [violet], thanks for the fixes on REPEALS_COUNCILID. However, it's still not showing up for active repeal resolutions. See the API response for the SC repeal resolution at vote: https://www.nationstates.net/cgi-bin/ap ... resolution

Compared to SC #204: https://www.nationstates.net/cgi-bin/ap ... resolution

REPEALS_COUNCILID is returned for SC #204, but it doesn't show up for the active resolution.

[Zora Imperium]

Idk where this goes I'm sorry, but where can I apply for a Client Key to recruit for my region?

[Greater Tern]

Idk where this goes I'm sorry, but where can I apply for a Client Key to recruit for my region?

File a GHR.

[Agadar]

Is there an easier way to retrieve regional happenings during a specific time period (say, last month) besides discovering the id of the first happening of the first day of said specific time period using the included timestamp and then iterating until the ending timestamp has been reached?

If not, would it be possible for timestamp-filtering to be made available for happenings? A similar feature is already supported for the nation history shard (it supports a 'from' and 'to' option, taking timestamps).

The reason I'd like to be able to select happenings by timestamps is because I'd like to discover programmatically how many endorsements people have given each month.

[[violet]]

"beforetime" and "sincetime" parameters are now supported in the Happenings API. See the doc for examples.

[Agadar]

"beforetime" and "sincetime" parameters are now supported in the Happenings API. See the doc for examples.

Neat. That certainly saves a lot of headache: I still have to make multiple calls and keep track of the last event id, but at least I don't have to manually check for the beginning-and ending timestamps now. Thanks!

[HMS Unicorn]

"beforetime" and "sincetime" parameters are now supported in the Happenings API. See the doc for examples.

Very useful. I've been meaning to ask for this for a while now (but I kept being lazy and just coding various workarounds instead...).

I will work to update several parts of my code that can benefit from this, and report back any issues.

Thanks a lot!

[Melorian Republic]

There doesn't seem to be a shard to track influence changes in a region. Is that a planned thing, or not?

[HMS Unicorn]

Were plain http (as opposed to secure https) calls disabled for the API?

It looks like http API calls now redirect to https, instead of returning the API call results. This seems to have started happening about an hour ago.

I was originally going to mark this as a bug report, but I realize it may be a planned development.

[Frisbeeteria]

I was originally going to mark this as a bug report, but I realize it may be a planned development.

Yes, it was planned.

[Imperium Anglorum]

The API documentation probably ought be updated to use HTTPS instead of HTTP.

[[violet]]

Yes, done, thanks.

[Krypton Nova]

I hope this is the right place to ask this

I can't seem to get data between two timestamps when it exceeds a certain amount of items.

For example this
https://www.nationstates.net/cgi-bin/ap ... 1483167600
gives me all nations who CTE'd during that period with the earliest being 1483165833 and the latest being 1483166399 (full timespan)

But this, which contains far more data over the same amount of time:
https://www.nationstates.net/cgi-bin/ap ... 1483167600
only gives me nation's legislation starting with the earliest being 1483167435 and the latest being 1483167596 (only the last 2 minutes)

How would I go about collecting the data between those timestamps in the second case? Should I make multiple smaller requests
with shorter time-spans, or is there a better way to get all data within one request?

[Trotterdam]

Check the earliest timestamp that actually got returned, then make your next call asking about events preceding that timestamp.

[HMS Unicorn]

You can also add limit=200 to the URL, to increase the number of events returned (the default is 100), and therefore decrease the number of API calls you need to make.

https://www.nationstates.net/cgi-bin/api.cgi?q=happenings;filter=cte;sincetime=1483160400;beforetime=1483167600;limit=200

[Krypton Nova]

You can also add limit=200 to the URL, to increase the number of events returned (the default is 100), and therefore decrease the number of API calls you need to make.

https://www.nationstates.net/cgi-bin/api.cgi?q=happenings;filter=cte;sincetime=1483160400;beforetime=1483167600;limit=200

Check the earliest timestamp that actually got returned, then make your next call asking about events preceding that timestamp.

I see... I'll work with that then.
Thanks for the help

[Gyflada]

For some reason, I can't create a new recruitment telegram.

I have all of the information I need, but when I go to create the telegram, tag it as API and mark it as a recruitment telegram for my region, it says my nation insn't allowed to recruitment for region.

Any ideas?