Get events

Get events according to your filters. You can use it to serve a map or event stream.

POST /v2/get/events

Get events

cURL

curl --request POST \
  --url https://www.wander-service.fr/api/clients/v2/get/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "categories": [],
  "sources": [
    "<string>"
  ],
  "locationFilter": {},
  "datesFilter": {
    "minDate": "<string>",
    "maxDate": "<string>"
  },
  "pricesFilter": {
    "lowestPrice": 123,
    "highestPrice": 123,
    "hasKnownPrice": true
  },
  "limit": 250.5,
  "pageNumber": 123,
  "getCommentaries": true,
  "getPerformers": true
}
'

import requests

url = "https://www.wander-service.fr/api/clients/v2/get/events"

payload = {
    "categories": [],
    "sources": ["<string>"],
    "locationFilter": {},
    "datesFilter": {
        "minDate": "<string>",
        "maxDate": "<string>"
    },
    "pricesFilter": {
        "lowestPrice": 123,
        "highestPrice": 123,
        "hasKnownPrice": True
    },
    "limit": 250.5,
    "pageNumber": 123,
    "getCommentaries": True,
    "getPerformers": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    categories: [],
    sources: ['<string>'],
    locationFilter: {},
    datesFilter: {minDate: '<string>', maxDate: '<string>'},
    pricesFilter: {lowestPrice: 123, highestPrice: 123, hasKnownPrice: true},
    limit: 250.5,
    pageNumber: 123,
    getCommentaries: true,
    getPerformers: true
  })
};

fetch('https://www.wander-service.fr/api/clients/v2/get/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.wander-service.fr/api/clients/v2/get/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'categories' => [
        
    ],
    'sources' => [
        '<string>'
    ],
    'locationFilter' => [
        
    ],
    'datesFilter' => [
        'minDate' => '<string>',
        'maxDate' => '<string>'
    ],
    'pricesFilter' => [
        'lowestPrice' => 123,
        'highestPrice' => 123,
        'hasKnownPrice' => true
    ],
    'limit' => 250.5,
    'pageNumber' => 123,
    'getCommentaries' => true,
    'getPerformers' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.wander-service.fr/api/clients/v2/get/events"

	payload := strings.NewReader("{\n  \"categories\": [],\n  \"sources\": [\n    \"<string>\"\n  ],\n  \"locationFilter\": {},\n  \"datesFilter\": {\n    \"minDate\": \"<string>\",\n    \"maxDate\": \"<string>\"\n  },\n  \"pricesFilter\": {\n    \"lowestPrice\": 123,\n    \"highestPrice\": 123,\n    \"hasKnownPrice\": true\n  },\n  \"limit\": 250.5,\n  \"pageNumber\": 123,\n  \"getCommentaries\": true,\n  \"getPerformers\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.wander-service.fr/api/clients/v2/get/events")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"categories\": [],\n  \"sources\": [\n    \"<string>\"\n  ],\n  \"locationFilter\": {},\n  \"datesFilter\": {\n    \"minDate\": \"<string>\",\n    \"maxDate\": \"<string>\"\n  },\n  \"pricesFilter\": {\n    \"lowestPrice\": 123,\n    \"highestPrice\": 123,\n    \"hasKnownPrice\": true\n  },\n  \"limit\": 250.5,\n  \"pageNumber\": 123,\n  \"getCommentaries\": true,\n  \"getPerformers\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.wander-service.fr/api/clients/v2/get/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"categories\": [],\n  \"sources\": [\n    \"<string>\"\n  ],\n  \"locationFilter\": {},\n  \"datesFilter\": {\n    \"minDate\": \"<string>\",\n    \"maxDate\": \"<string>\"\n  },\n  \"pricesFilter\": {\n    \"lowestPrice\": 123,\n    \"highestPrice\": 123,\n    \"hasKnownPrice\": true\n  },\n  \"limit\": 250.5,\n  \"pageNumber\": 123,\n  \"getCommentaries\": true,\n  \"getPerformers\": true\n}"

response = http.request(request)
puts response.read_body

201

{
  "data": [
    {
      "id": 123,
      "wanderId": 123,
      "wanderLink": "<string>",
      "name": "<string>",
      "startDate": "<string>",
      "endDate": "<string>",
      "hasEndDateNotReliable": true,
      "lowestPrice": 123,
      "highestPrice": 123,
      "description": "<string>",
      "hasGoodDeal": true,
      "image": "<string>",
      "imageHeight": 123,
      "imageWidth": 123,
      "squareImage": "<string>",
      "rectangleImage": "<string>",
      "webImage": "<string>",
      "notAvailableAt": "<string>",
      "cancelledAt": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "googlePlace": {
        "id": "<string>",
        "name": "<string>",
        "address": "<string>",
        "lng": 123,
        "lat": 123,
        "averageGrade": 123,
        "totalGrades": 123,
        "street": "<string>",
        "city": "<string>",
        "postalCode": "<string>",
        "country": "<string>",
        "photoRef": "<string>",
        "website": "<string>",
        "editorialSummary": "<string>",
        "periods": [
          {
            "open": {
              "day": 123,
              "time": "<string>"
            },
            "close": {
              "day": 123,
              "time": "<string>"
            }
          }
        ]
      },
      "place": {
        "id": 123,
        "googleId": "<string>",
        "name": "<string>",
        "address": {
          "lng": 123,
          "lat": 123,
          "street": "<string>",
          "city": "<string>",
          "postalCode": "<string>",
          "country": "<string>"
        },
        "image": "<string>",
        "squareImage": "<string>",
        "rectangleImage": "<string>",
        "averageGrade": 123,
        "totalGrades": 123
      },
      "sources": [
        {
          "id": 123,
          "partner": {
            "name": "<string>",
            "logo": "<string>",
            "backColor": "<string>"
          },
          "startDate": "<string>",
          "endDate": "<string>",
          "lowestPrice": 123,
          "highestPrice": 123,
          "isGoodDeal": true,
          "commissionFix": 123,
          "commissionPerTicket": 123,
          "commissionPerCart": 123,
          "commissionRate": 123,
          "link": "<string>",
          "isBookable": true,
          "availableDates": [
            {
              "startDate": "<string>",
              "endDate": "<string>",
              "hasEndDateNotReliable": true,
              "hasUnknownAvailability": true
            }
          ],
          "averageGrade": 123,
          "totalGrades": 123,
          "cantRetrieveAvailableDates": true,
          "notAvailableAt": "<string>"
        }
      ],
      "categories": [
        {
          "id": 123,
          "mainCategory": "<string>",
          "subCategory": "<string>",
          "traductionFR": "<string>",
          "traductionEN": "<string>",
          "icon": "<string>"
        }
      ],
      "commentaries": [
        {
          "grade": 123,
          "content": "<string>",
          "username": "<string>",
          "date": "<string>"
        }
      ],
      "averageGrade": 123,
      "totalGrades": 123,
      "trendingScore": 123,
      "performers": [
        {
          "id": 123,
          "name": "<string>",
          "description": "<string>",
          "image": "<string>",
          "webImage": "<string>"
        }
      ]
    }
  ],
  "pagination": {
    "totalItems": 123,
    "totalPages": 123,
    "perPage": 123,
    "currentPage": 123,
    "nextPageParams": {
      "pageNumber": 123,
      "limit": 123
    },
    "previousPageParams": {
      "pageNumber": 123,
      "limit": 123
    }
  }
}

Authorizations

Authorization · string · header · required

It is the "access_token" returned after login

Body

application/json

categories · enum<string>[]

It is a filter. By default, you get all the event categories.

Minimum array length: 1

Available options: atelier, brocante, cinema, conference, enfants, expo, festival, gastronomie, livres, loisirs, meeting, musique, nature, pro, salon, sciences, soiree, solidarite, spectacle, sport, visite, none

sources · string[]

It is a filter. By default, you get all sources. Check the back office for possible values.

Minimum array length: 1

locationFilter · object

You can define a location filter corresponding to a circle or a rectangle.

Option 1

Option 2

Show child attributes

datesFilter · object

Option 1

Option 2

Show child attributes

pricesFilter · object

Show child attributes

limit · number

Required range: 1 <= x <= 500

Example:

5

pageNumber · number

Example:

1

orderBy · enum<string>

You can order the events you get by dates or by prices or by distance to a place definied with 'orderByDistance' or by last update dates to update your records. By default it's by ascendant endDates.

Available options: startDate, endDate, updatedAt, lowestPrice, highestPrice, distance

Example:

"distance"

orderByDistance · object

You can define the coordinates of a place to order events according to their distance from that place.

Show child attributes

getCommentaries · boolean

Set it to true if you want to retrieve commentaries on events you get. Warning, this reduces the performance of the request, so only use it if you want to use this data.

Example:

false

getPerformers · boolean

Set it to true if you want to retrieve performers on events you get. Warning, this reduces the performance of the request, so only use it if you want to use this data.

Example:

false

Response

201

application/json

Successful operation

data · object[]

Show child attributes

pagination · object

Show child attributes