1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
# Samples
The samples endpoint provides an easy way to access hourly batches of random match data to aggregate stats.
{% method %}
## Get a collection of Samples
This endpoint retrieves a collection of randomly selected matches.
{% sample lang="shell" %}
```shell
curl "https://api.dc01.gamelockerapp.com/shards/na/samples" \
-H "Authorization: Bearer <api-key>" \
-H "Accept: application/vnd.api+json"
```
{% sample lang="java" %}
```java
//There are a variety of Java HTTP libraries that support query-parameters.
```
{% sample lang="python" %}
```python
```
{% sample lang="ruby" %}
```ruby
```
{% sample lang="js" %}
```javascript
```
{% sample lang="go" %}
```go
```
{% sample lang="swift" %}
```swift
let urlString = "https://api.dc01.gamelockerapp.com/shards/na/samples"
func downloadJsonWithTask() {
let url = NSURL(string: urlString)
var downloadTask = URLRequest(url: (url as URL?)!, cachePolicy: URLRequest.CachePolicy.reloadIgnoringCacheData, timeoutInterval: 20)
downloadTask.httpMethod = "GET"
downloadTask.addValue("APIKey", forHTTPHeaderField: "Authorization")
downloadTask.addValue("application/vnd.api+json", forHTTPHeaderField: "Accept")
URLSession.shared.dataTask(with: downloadTask) { (data, response, error) in
if let response = response {
print(response)
}
if let data = data {
do {
let jsonData = try JSONSerialization.jsonObject(with: data, options: .allowFragments) as? NSDictionary
print(jsonData!.value(forKey: "data") as Any)
} catch {
print(error)
}
}
}.resume()
}
```
{% common %}
> The above command returns JSON structured like this:
```json
{
"type": "sample",
"id": "sample-na-2017-02-28T07:15:30Z",
"attributes": {
"URL": "URL of Sample Matches",
"createdAt": "2017-02-28T07:15:30Z",
"shardId": "na",
"t0": "2017-02-28T07:15:30Z",
"t1": "2017-02-28T08:15:30Z",
"titleId": "semc-vainglory"
},
"relationships": {
"assets": {
"data": []
}
}
}
```
{% endmethod %}
### HTTP Request
`GET https://api.dc01.gamelockerapp.com/shards/na/samples`
### Query Parameters
Parameter | Default | Description |
--------- | ------- | -----------
page[offset] | 0 | Allows paging over results
page[limit] | 50 | The default (and current maximum) is 50. Values less than 50 and great than 2 are supported.
sort | createdAt | By default, samples are sorted by creation time ascending.
filter[createdAt-Start] | none | Must occur before time. Format is iso8601 Usage: filter[createdAt-end]=2017-01-01T08:25:30Z
filter[createdAt-End] | none | Must occur after time. Format is iso8601 Usage: filter[createdAt-end]=2017-01-01T13:25:30Z
|
