GetEventList

public BackndEventReturnObject GetEventList();
public BackndEventReturnObject GetEventList(int limit);
public BackndEventReturnObject GetEventList(int limit, string offset);

Parameters

Value	Type	Description
limit	int	(Optional) Number of events to be loaded
offset	string	(Optional) Starting point of the events to be loaded It can be obtained via BackndReturnObject.LastEvaluatedKeyString().

BackndEventReturnObject

GetReturnValueByEventList

If an error occurred, null is returned.

BackndEventReturnObject bro = Backnd.Event.GetEventList(10);

if(bro.IsSuccess()) {
    List<BackndEventItem> eventList = bro.GetReturnValueByEventList();
}

BackndEventItem

public class BackndEventItem
{
    public string uuid;
    public string content;
    public string contentImageKey;
    public string popUpImageKey;
    public DateTime postingDate;
    public DateTime startDate;
    public DateTime endDate;
    public string inDate;
    public string linkUrl;
    public string author;
    public bool isPublic;
    public string linkButtonName;
    public string title;
}

Description

This is a function for receiving the events registered in BACKND Console.

• When the user has a country code and an event of that country is registered in the console → The event's title and content for that country will be returned.
• If the user's country code is not present, or if an event is not registered for the country in the console → Returns the default title and content.

Example

Synchronous

//Calls 10 events lists
BackndEventReturnObject bro = Backnd.Event.GetEventList(10);

if(bro.IsSuccess()) {
    //Event 10 after calling 10 events
    string offset = bro.LastEvaluatedKeyString();
    if(!string.IsNullOrEmpty(offset)) {
        // 2. Loads 3 events after loading 2 events
        Backnd.Event.GetEventList(3, offset);
    }
}

Asynchronous

Backnd.Event.GetEventList(2, (callback) => {
    // Post-process
    if(callback.IsSuccess()) {
        string offset = callback.LastEvaluatedKeyString();
        if(!string.IsNullOrEmpty(offset)) {
            // 2. Loads 3 events after loading 2 events
            Backnd.Event.GetEventList(3, offset, (callback2) => {
                // Post-process
            });
        }
    }
});

Return cases

Success cases

When loaded successfully
statusCode : 200

returnValue : refer to GetReturnValuetoJSON

When the number of events is 0
statusCode : 200

returnValue : { "rows":[] }

---

GetReturnValuetoJSON

In the case of success, the information about the registered events is displayed.

{ 
    rows:
    [ 
        { 
            uuid: // Event uuid
                { S : "b33bc260-0981-11e9-bfd0-3bf848e9c52c" },
            content: // Content of event
                { S: "Enter a coupon number to receive items!" },
            contentImageKey: // Attached content image URL
                { S : "/upload/2147483648/event/2018-12-27T02:46:57.391Z312652213.jpg" },
            popUpImageKey: // Attached pop-up image URL 
                { S : "/upload/2147483648/event/2018-12-27T02:46:58.945Z936251230.jpg" },
            postingDate: // Event publication date
                { S : "2018-12-27T02:00:00.000Z" },
            endDate: // Event end date 
                { S : "2018-12-28T03:00:00.000Z" },
            inDate: // Event indate
                { S : "2018-12-27T02:47:07.399Z" },
            startDate: // Event start date
                { S : "2018-12-27T03:00:00.000Z" },
            linkUrl: // External link button URL
                { S : "http://thebackend.io" },
            isPublic: // Public/private status(y: public)
                { S : "y" },
            linkButtonName: // The name of the external link
                { S : "buttonX" },
            author: // Author information(admin nickname)
                { S : "jake" },
            title: // Event title
                { S: "An event to celebrate 100,000 downloads!" }
        },
        { 
            uuid: [Object],
            content: [Object],
            contentImageKey: [Object],
            popUpImageKey: [Object],
            postingDate: [Object],
            endDate: [Object],
            inDate: [Object],
            startDate: [Object],
            linkUrl: [Object],
            isPublic: [Object],
            linkButtonName: [Object],
            author: [Object],
            title: [Object] 
        }  
    ],
    // Returned when there is data after the loaded data
    // Not returned if no data exists after the loaded data
    LastEvaluatedKey:{
        gamer_id: { S: "event" },
        inDate:{ S: "2019-08-19T06:45:07.816Z" },
        partition:{ S: "event" }
    }
}

Sample code

public class EventItem
{
    public string uuid;
    public string content;
    public string contentImageKey;
    public string popUpImageKey;
    public DateTime postingDate;
    public DateTime startDate;
    public DateTime endDate;
    public string inDate;
    public string linkUrl;
    public string author;
    public bool isPublic;
    public string linkButtonName;
    public string title;

    public override string ToString()
    {
        return $"uuid : {uuid}\n" +
        $"content : {content}\n" +
        $"contentImageKey : {contentImageKey}\n" +
        $"popUpImageKey : {popUpImageKey}\n" +
        $"postingDate : {postingDate}\n" +
        $"startDate : {startDate}\n" +
        $"endDate : {endDate}\n" +
        $"inDate : {inDate}\n" +
        $"linkUrl : {linkUrl}\n" +
        $"author : {author}\n" +
        $"isPublic : {isPublic}\n" +
        $"linkButtonName : {linkButtonName}\n" +
        $"title : {title}\n";
    }
}

public void GetEventListTest()
{
    List<EventItem> eventList = new List<EventItem>();

    BackndReturnObject bro = Backnd.Event.GetEventList(10);

    if(bro.IsSuccess())
    {
        Debug.Log("Return value: " + bro);
        BACKND.LitJson.JsonData jsonList = bro.FlattenRows();
        for(int i = 0; i < jsonList.Count; i++)
        {
            EventItem eventItem = new EventItem();

            eventItem.title = jsonList[i]["title"].ToString();
            eventItem.content = jsonList[i]["content"].ToString();
            eventItem.postingDate = DateTime.Parse(jsonList[i]["postingDate"].ToString());
            eventItem.startDate = DateTime.Parse(jsonList[i]["startDate"].ToString());
            eventItem.endDate = DateTime.Parse(jsonList[i]["endDate"].ToString());
            eventItem.inDate = jsonList[i]["inDate"].ToString();
            eventItem.uuid = jsonList[i]["uuid"].ToString();
            eventItem.isPublic = jsonList[i]["isPublic"].ToString() == "y" ? true : false;
            eventItem.author = jsonList[i]["author"].ToString();

            if(jsonList[i].ContainsKey("contentImageKey"))
            {
                eventItem.contentImageKey = "http://upload-console.thebackend.io" + jsonList[i]["contentImageKey"].ToString();
            }
            if(jsonList[i].ContainsKey("popUpImageKey"))
            {
                eventItem.popUpImageKey = "http://upload-console.thebackend.io" + jsonList[i]["popUpImageKey"].ToString();
            }
            if(jsonList[i].ContainsKey("linkUrl"))
            {
                eventItem.linkUrl = jsonList[i]["linkUrl"].ToString();
            }
            if(jsonList[i].ContainsKey("linkButtonName"))
            {
                eventItem.linkButtonName = jsonList[i]["linkButtonName"].ToString();
            }

            eventList.Add(eventItem);
            Debug.Log(eventItem.ToString());
        }
    }
}

How to look up an image attached to the event

If you registered a content image and pop-up image when registering the event, you can check the address where the images are stored using the contentImageKey and popUpImageKey values, respectively, in the above GetReturnValuetoJSON() value.

To look up the image, add its image key to the image key returned to http://upload-console.thebackend.io and make a request to the address shown below.

http://upload-console.thebackend.io/upload/2147483648/event/2018-12-27T02:46:57.391Z312652213.jpg

Caution for iOS

iOS blocks http access as a default setting according to its security policy.
If you wish to load an image attached to an announcement/event from an iOS device, allow all http or add certain domains as exceptions as shown below.

Open Info.lplist after building a project > In 'Key,' find or create the value of App Transport Security Settings Key.

Case 1. When allowing all Http access:

Go to App Transport Security Settings and change Allow Arbitrary Loads to YES.

Case 2. When allowing access only from certain domains

• Go to App Transport Security Settings and change Allow Arbitrary Loads to NO.
• In the options of App Transport Security Settings, create Exception Domains and add upload-console.thebackend as its subcategory.