GetMCML

Contents

What is ParaWorld API?

ParaWorld API is an evolving collection of web service or REST interface. You can add social context to your application by calling these API to access user profile, friend, photo, map, and many other official application interface.

Web serivce vs. REST Interface

API uses both web service and REST-like interface. REST interface means that all web method calls are made over the Internet by sending HTTP GET or POST requests to the our servers. Nearly any computer language can be used to communicate over HTTP with our servers.

The query result can be returned either in XML format or NPL table format. The latter is more compact and more readable by human beings and is the default format used by our official servers.

API Methods

APIs are organized by namespaces. The sample code in this article assumes that you are using the NPL web service wrapper which is located in script/app/API folder of the client installation.

auth paraworld.auth.AuthUser paraworld.auth.Logout paraworld.auth.VerifyUser paraworld.auth.CheckVersion friends paraworld.friends.get paraworld.friends.add paraworld.friends.remove profile paraworld.profile.SetMCML paraworld.profile.GetMCML users paraworld.users.getInfo paraworld.users.setInfo paraworld.users.isAppAdded

map paraworld.map.UploadFile paraworld.map.OfficialMap paraworld.map.UserMap paraworld.map.GetWorlds paraworld.map.GetMapMarkOfPage paraworld.map.GetMapMarksInRegion paraworld.map.GetMapModelByIDs paraworld.map.GetMapModelOfPage paraworld.map.GetTilesInRegion paraworld.map.GetMapMarkByID paraworld.map.AddMapMark paraworld.map.RemoveMapMark paraworld.map.AddModel paraworld.map.GetModelByID paraworld.map.UpdateModel paraworld.map.RemoveModel paraworld.map.SearchMapMark paraworld.map.AddTile paraworld.map.GetTileByID paraworld.map.UpdateTile paraworld.map.PublishWorld paraworld.map.GetWorldByID paraworld.map.UpdateWorld paraworld.map.RemoveWorld paraworld.map.BuyTile

actionfeed paraworld.actionfeed.PublishStoryToUser paraworld.actionfeed.PublishActionToUser paraworld.actionfeed.PublishRequestToUser paraworld.actionfeed.PublishMessageToUser paraworld.actionfeed.PublishItemToUser paraworld.actionfeed.sendEmail inventory paraworld.inventory.GetBag paraworld.inventory.AddItem paraworld.inventory.RemoveItem lobby paraworld.lobby.CreatRoom paraworld.lobby.JoinRoom paraworld.lobby.GetRoomList marketplace paraworld.marketplace.GetBags paraworld.marketplace.AddBag paraworld.marketplace.RemoveBag

Additional documentation

• Authentication guide
• Error codes

Usage Examples in NPL

• Photo uploads
• Marketplace Listing
• Map Editing
• Publish World
• Profile box MCML
• User and friends Info

External tools

• facebook's api test console: http://developers.facebook.com/tools.php
• FBML: http://wiki.developers.facebook.com/index.php/FBML
• TODO: Create our own test console as a TestConsoleApp