openactive / implementation-tracker

Activation Issue Tracker for OpenActive Implementations
1 stars 2 forks source link

Example Games on sportstarta.com #76

Closed ansontp22 closed 1 year ago

ansontp22 commented 7 years ago
{
    "data": {
        "date": "17.05.2017",
        "date_edit": "2017-05-17",
        "time": "05:23 PM",
        "startMid": "pm",
        "startHour": "5",
        "startMinute": "23",
        "endMid": "pm",
        "endHour": "5",
        "endMinute": "33",
        "unixTimeCurrent": "1494954910",
        "unixTimeStart": "1495041780",
        "unixTimeEnd": "1495042380.000000",
        "alreadyStarted": "0",
        "time_ends": "2017-05-17 17:33:00.000000",
        "time_start": "2017-05-17 17:23:00",
        "playersNeeded": "0",
        "regular": "1",
        "minplayersNeeded": "8",
        "maxplayersNeeded": "16",
        "openToAll": "1",
        "openToContacts": "0",
        "info": "this will work",
        "address": "680020",
        "localization": "10, Karunakaran Nambiar Rd, Chembukkav",
        "club_phone_no": "",
        "game_id": "297",
        "lat": "10.527642",
        "lng": "76.214432",
        "payment": "",
        "playersGender": null,
        "canceled": null,
        "privileage": "0",
        "type": "tennis",
        "id": "18",
        "category": "racket",
        "category_id": "2",
        "color": "yellow",
        "playerjoined": "1",
        "rate": null,
        "genre": null,
        "speed": null,
        "nature": "Club Event",
        "distance": null,
        "surface": "grass",
        "ball": null,
        "standard": "high intermediate",
        "gameComments": []
    }
}
nickevansuk commented 7 years ago

Great to see your fields. I've had a go at matching as many as I could see to the modelling specification (https://www.openactive.io/modelling-opportunity-data/), and included the surrounding paging mechanism too (https://www.openactive.io/realtime-paged-data-exchange/). See below for what a page of your API containing 1 item should look like (without the /* */ comments):

{
  "next": "/api/OpenData/sessions?afterTimestamp=3447128965&afterId=18",
  "items": [
    {
      "state": "updated",
      "kind": "session",
      "id": "18",
      "modified": 1494954910,
      data: {
        "@context": "https://www.openactive.io/ns/oa.jsonld",
        "type": "Event",

        "identifier": 18, /* id */

        "name": "Tennis Club Event",
        "url": "https://www.sportstarta.com/session/18",
        "image": "https://www.sportstarta.com/wp-content/uploads/water.jpg",

        "startDate": "2017-07-17T17:23:00Z", /* Note ISO8601 format */
        "endDate": "2017-07-17T17:33:00Z", 

        "description": "this will work", /* info */

        "location": {
          "type": "Place",
          "address": {
            "type": "PostalAddress",
            "streetAddress": "1 High Street", /* localization */
            "postalCode": "BS1 4SD" /* VenueAddress */
          }
          "geo": {
            "latitude": 10.527642, /* lat */
            "longitude": 76.214432 /* lng */
          }
        },

        "telephone": "01494 791 779" /* club_phone_no */

        "level": "high intermediate", /* standard */

        "genderRestriction": "mixed", /* playersGender */

        "activity": "tennis", /* tennis */

        "additionalData": {
            "date_edit": "2017-05-17",
            "alreadyStarted": "0",
            "playersNeeded": "0",
            "regular": "1",
            "minplayersNeeded": "8",
            "maxplayersNeeded": "16",
            "openToAll": "1",
            "openToContacts": "0",

            "game_id": "297",
            "payment": "",
            "canceled": null,
            "privileage": "0",

            "category": "racket",
            "category_id": "2",
            "color": "yellow",
            "playerjoined": "1",
            "rate": null,
            "genre": null,
            "speed": null,
            "nature": "Club Event",
            "distance": null,
            "surface": "grass",
            "ball": null,
            "gameComments": []
        }
    }
  ],
  "license": "https://creativecommons.org/licenses/by/4.0/"
}

Do you have any of the following:

For the next step, please provide a URL of your implementation that conforms to the above. We will then test this for you.

Please also take a look at the implementation checklist: https://github.com/openactive/realtime-paged-data-exchange - specifically the last bullet point, for when you implement the endpoint:

Any questions feel free to shoot us a message on the chat https://github.com/openactive/public-openactive-w3c

ansontp22 commented 7 years ago

Hi @nickevansuk Thanks for your feedback

I've few more doubts

what are these fields stands for and are these mandatory? state, kind, context,aftertimestamp ,afterId

Also I don't think we have next url. Could you please let me know more about it?

Regards Anson

nickevansuk commented 7 years ago

Please have a look at this doc:

https://www.openactive.io/realtime-paged-data-exchange/