Jump to content
  • Announcements

    • Orioni

      Hello new member   02/03/2018

      Welcome to Europa. This site is part of the region of Europa in the online game NationStates. The region of Europa is a diverse community of nations, with a wide range of political and ideological values, working together through various institutions and alliances - at least when they're not threatening to go to war with each other. Whether you want to play it safe with a liberal democracy, set up a communist regime, or rule your citizens with an iron fist and the threat of turning them into dog food, Europa is a great region to play in. As one of the oldest regions in the game, everybody who's anybody wants to try their hand at ruling their own country right here in Europa. Just head on over to the Forum and have a read through the sticky threads. If you're curious about how all of this work, we've included some helpful links to get you started. A good place to start is our Hitchhickers Guide to Europa. Roleplayers will be glad to see our honest and fair RP rules. Check out our map versions and discover how to apply. Experiencing problem with this website? Our helpdesk is always open. Have fun! -- The Europans Team
Sign in to follow this  
Invision Power

4.3: REST API Enhancements

Recommended Posts

code.jpg.44c1e7ade57fd28f1bf1c07619f6b5b1.jpg

"No man is an island" wrote John Donne. He wrote that a good 200 years before computers were invented, but it rings true for any well written framework like Invision Community.

The included REST API allows developers to fetch data from Invision Community and also allows data to be added.

This data can be used to power widgets on your website, or to be used within other applications you  are already using in a very simple way.

coding-924920_1280.thumb.jpg.f9a754d5c814494cb5312dcee3dd02f7.jpg

 

Several enhancements have been made to the REST API for Invision Community 4.3 that we wanted to let you know about.

These changes are developer-oriented, so if you do not use the REST API with your community please feel free to skip this update.

If you would like to learn more about the REST API available with Invision Community, please see our REST documentation.

Search capabilities

As previously noted, you can now perform searches through the REST API. You can perform searches based on keywords, tags, or both, and you can limit and filter results with parameters similar to when you perform a regular search on the site (e.g. to specific containers, returning only results over a set number of comments, or searching within clubs).

Permission awareness

Several REST API endpoints are now permission-aware when combined with Oauth functionality built into Invision Community 4.3. This means that many REST API endpoints can be called using a specific user's access token, and only results that the specific user would normally be able to see will be returned (and/or they will only be able to submit to areas they normally have permission to). 

Ability to search members

While an endpoint has always been available to retrieve (and add/edit/delete) members, the ability to search for members has now been implemented. You can search by name, email address, and (one or more) group(s), and a paginated response will be returned.

Private conversations

You can now start a new private conversation, reply to an existing private conversation, and delete a private conversation through the REST API.

Other REST API changes

  • You can now specify member's secondary groups when adding or updating a member through the REST API.
  • You can specify the member's registration IP address through the REST API when adding or updating a member.
  • You can now specify other member properties not directly exposed through the REST API when adding or updating a member by setting the rawProperties input field.
  • You can now specify other member properties to retrieve through the REST API through the otherFields request parameter.
  • The REST API now better logs changes to member accounts (so you will be able to more easily identify how a user's name, email address, password, etc. has changed when looking at the member history).
  • You can now retrieve all content a member is following through the REST API, as well as follow a new container/content item, and delete an existing follow.
  • You can now validate an account through the REST API
  • You can now specify a 'perPage' parameter for paginated responses to control how many items are returned per page.

 

Most of these changes were directly culled from client feedback and implemented per specific requests. If there are other REST API changes you would like to see implemented please don't hesitate to leave your feedback!

View the full article

Share this post


Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
Sign in to follow this  

  • Our picks

    • A military trade agreement between the nations of Fleur de Lys and Astriedan. "Following a rather small and fast contact with one of our representative in travel in Astriedan, it has come to our intention the will of the United Houses to modernised its aerial component of its military force. Which is why, in agreement of what we understood, I allow myself as DC of Aérospatiale to write you this letter to further know your intentions and in the hope of developing the needs and how we may fill them."
      • 11 replies
    • Summer has started in Antargis. The land of the eternal ice is being flooded with diffuse light, the ice slowly retreats, penguin chicks hatch and cute little seal pups open their round eyes for the first time. Whales graze on the abundant masses of plankton and krill cumulating in the frigid waters. But this year, something is different about the southernmost continent. There is a building standing between dunes of snow amidst the freezing haze. It is the Simon Station, the ISTC's foothold on the frozen continent.
        • Love
      • 4 replies
    • Morheim creates the Treaty for Cultural and Historical Exchange (TCHE), a multi-national organisation designed to promote co-operation in several academic fields as well as opening its citizen's eyes to the cultures of neighbours and potential friends. It is their hope that you will accept my invitation to meet with Queen Julia III and her team at Thale Royal Palace to discuss this concept and reach a mutually acceptable treaty which will kick-start this ambition of a young Archaeology student.
        • Like
        • Love
      • 20 replies
    • Tonight on Ahrana Today (AT) we have a special edition on the Communist Takeover. It is important to know and understand how regimes rise and fall. Tonight we focus on the new Government of Ahrana, the Communist. In order for us to truly understand, we must go back to where it all began, and see why the movement was so successful. Now is the time to show the world why the Communist are here.
      • 35 replies
    • TO ALL ATARA MEMBERS & OBSERVERS: The Interim Administration of the Argic-Thalassan-Alharun Regional Association wishes to congratulate the delegate and the delegate's great nation for fonal acceptance into this economic cooperative. In keepin with the confirmation of our esteemed member and observer states, we are formally extending this official invitation to the signing ceremony of the ATARA Charter.
        • Like
      • 16 replies
  • Who's Online (See full list)

  • Posts

    • Military R&D making great progress Earlier today, testing for a 3.35 meter tall mech design began in northern Lithuania. From what first-hand witnesses have told the Times, the mech was able to destroy a car with relative ease, shoot fire, and smash through rubble. Other projects shown off at the testing site included a new type of suit able to make the wearer jump slightly higher than normal, light-activated night vision goggles, and improved military-grade shields. In addition, a large artillery piece with a built in targeting system was demonstrated.  Check back tomorrow for more updates from the Commonwealth Times, your local, and absolutely only, news network.
    • International News DONA PARASS HOSTAGE SITUATION ENDS IN FIREFIGHT- 12 PASSENGERS SLAIN February 14, 2018   -12 Passengers, 2 Navy, 30 Hijackers dead in hostage rescue operation Sakspati Cape, International Waters- Early this morning, members of the Armada Special Operations Command launched a large operation for the rescue of the remaining passengers of the Dona Parass cruise ship which had been hijacked by a large Circle of Death cell just yesterday. The hijackers had immediately claimed their affiliation with the Hellenic Russian, now international, terrorist organisation. Sources in Corregidor Maritime Command (CMC) have claimed that the hijackers had attempted to run the Dona Parass aground on a nearby reef, so that their ground accomplices could proceed to move hostages and plunder from the cruise ship. However, our source also claims that this plan was thwarted by an Armada Redentor class Littoral Combat Ship, the VRI Sant Tomas (LCS-018) which had intercepted the hijacked ship as she bore down on the reef. Officer in charge of the hostage rescue operation, Comandante Gregorio Segovia, of the Armada Special Boat Unit (SBU), reportedly forced the operation underway 4 hours earlier than originally planned, citing the possibility of greater loss of hostage lives due to the "daring interception made by the Sant Tomas". This decision, however, came at a cost. The details are yet to be confirmed by Corregidor, but as of now, we can ascertain that the early launch of the operation had caught support assets like aerial reconnaissance and Republican Marine Corps (RMC), unable to respond in time. In the ensuing chaos, 2 SBU operators were killed by hostile fire and 3 more were seriously injured in what can only be speculated from amateur videography as a gas explosion from amidships--which claimed 9 of the total civilian casualties. As Corregidor has yet to release the complete data on the mission, INBC cannot yet confirm the exact events which have just taken place on the Dona Parass, though NGOs and medical units have released some data able to paint a figure of the results. The hijackers had purportedly numbered just shy of 200 men, 30 of which were killed, another 50 injured, while the rest were able to flee on skiffs used for the initial boarding. 12 Civilians were killed, with another 20 injured by stray fire, shrapnel, or burns from the gas explosion. CMC has also yet to release the status of the 3 wounded Armada personnel. More on this as follows.   MUTUAL EMBASSIES WITH GALLAMBRIA February 21, 2018 In a short Palá conference today, Primo Franso Deitorr included a statement expressing the Republic's intention to expand diplomatic ties with the Kingdom of @Gallambria . According to Primo Deitorr's statement; "Iverican-Gallambrian ties have been strengthened in the wake of the recent tragedies befalling Walmington On Sea. Noting that the Kingdom has not only recognised our openness to cooperation in the recent months, allowing our diplomatic parties a formal embassy, as well as recognising the efforts of our valiant civil servicepersons working to create a safer Walmington On Sea--it is only natural that we likewise provide mutual establishment for the Gallambrian delegations. I am proud to announce that the Republic will be opening the diplomatic district to a Gallambrian Embassy. We are confident that this establishment will only prove to cement our relations for future endeavours and further aid in solidarity against any mutual tribulations that may come." When questioned about the possibility of future joint-projects with the Kingdom, Primo Deitorr suggested that the Republic would be "open to any joint military exercises, or any mutual infrastructure development that His Majesty Albert II or the Gallambrian Parliament, might be likewise inclined to". ---
    • Defence White Paper paints grim strategic picture HMGS Ocean during a day of exercises in Newport Beneath the surface hurly-burly of defence politics about "freedom of navigation patrols" and where build our new submarines, there are greater and more enduring currents of Gallambria's interests in a changing world. The surface impress of Anthony Greenwald was that he is less hawkish than his national security-focused predecessor, that he might well place less of a priority on defence spending.  Questions abounded as to whether he would keep the promise to spend 2 per cent of the nation's wealth on defence by early next decade as Johann Haasbroek had promised. Monday's white paper put those doubts firmly at rest. The fact that Greenwald has wedged into sticking with the 2 percent pledge - to abandon it would have caused a tsunami on his party's right wing - no doubt played a role. But Greenwald's motives make little difference to the rest of the world. In defence, action speak louder than words, especially when the action is the outlay of 195 billion pound in new military hardware acquisition over the next five years. By most assessments then, Monday's Defence White Paper is a clear statement that Gallambria is in the game of Marenesia's rising wealth, influence and military spending. At the strategic heart of the document is the rise of communism within the northern hemisphere. John Prollecks, a professor of security and strategic studies at the Gallambrian National University called the paper nothing less than "the end of the illusion in Bromwich that somewhow Communism, is not a threat to our democratic way of life." The language in the paper, Prollecks wrote in a blog post for the Gallambrian Strategic Policy Institute, made it "unmistakably clear that Bromwich's assessment about the trajectory of Communism's rise in influence has become more pessimistic." The sharpness of the paper's language is captured by a section that states "while it is natural for newly powerful countries to seek greater influence" some have "sought to challenge the natural order of our ultimate aim for world peace, by challenging the rules that govern actions in the global commons in unhelpful ways, leading to uncertainty and tension".    
    • The Commonwealth Times under stricter ownership Following a few recent stories published by the Commonwealth Times that showed our glorious government as less-then-perfect, the King has taken full ownership of the company, and a new set of staff has been put in place. All previous workers of the Times will be provided with full financial aid and free housing. We promise. In addition to this, all other regional newspapers of the Commonwealth have been merged with the Commonwealth Times to make sure that no false news is being printed. At all. Check back tomorrow for more updates from the Commonwealth Times, your local, and absolutely only, news network.
    • Nation: Little Flau Flag: my avatar (or check my factbook) Culture: Pacific islander and hippies Location: Archipelago of 6 islands (preferably the ones off the coast of Aurelia as I already started RP'ing as them. It is not a problem if I cannot go there as I can rewrite my history ) Climate: Tropical islands History: Culturally close islands living separate for a few hundred years but uniting 20 ago to promote peace, trade and environmental protection.
  • Topics

×