Pull the next command
curl --request POST \
--url https://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"onlineIdentifiers": [
"Steve",
"Alex"
]
}
'import requests
url = "https://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull"
payload = { "onlineIdentifiers": ["Steve", "Alex"] }
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({onlineIdentifiers: ['Steve', 'Alex']})
};
fetch('https://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull', 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://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull",
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([
'onlineIdentifiers' => [
'Steve',
'Alex'
]
]),
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://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull"
payload := strings.NewReader("{\n \"onlineIdentifiers\": [\n \"Steve\",\n \"Alex\"\n ]\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://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"onlineIdentifiers\": [\n \"Steve\",\n \"Alex\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull")
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 \"onlineIdentifiers\": [\n \"Steve\",\n \"Alex\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"command": "lp user Steve parent add vip",
"id": 4512
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}Command execution
Pull the next command
Claims at most one due command for the server and moves it to PROCESSING. Report it with done or fail before pulling again: while a command is processing, pull answers 204. Throttled per server, shared with the official connector.
POST
/
v1
/
seller
/
servers
/
{serverId}
/
commands
/
pull
Pull the next command
curl --request POST \
--url https://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"onlineIdentifiers": [
"Steve",
"Alex"
]
}
'import requests
url = "https://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull"
payload = { "onlineIdentifiers": ["Steve", "Alex"] }
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({onlineIdentifiers: ['Steve', 'Alex']})
};
fetch('https://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull', 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://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull",
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([
'onlineIdentifiers' => [
'Steve',
'Alex'
]
]),
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://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull"
payload := strings.NewReader("{\n \"onlineIdentifiers\": [\n \"Steve\",\n \"Alex\"\n ]\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://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"onlineIdentifiers\": [\n \"Steve\",\n \"Alex\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gamecart.gg/v1/seller/servers/{serverId}/commands/pull")
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 \"onlineIdentifiers\": [\n \"Steve\",\n \"Alex\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"command": "lp user Steve parent add vip",
"id": 4512
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}{
"code": "ORDER_NOT_FOUND",
"detail": "Order not found.",
"errors": [
{
"code": "validation.required",
"field": "content",
"message": "This field is required."
}
],
"instance": "/v1/seller/orders/GC-NOPE",
"requiredScope": [
"orders:read",
"orders:buyer:read"
],
"retryAfterSeconds": 17,
"status": 404,
"title": "Not Found",
"traceId": "ede70d1d-66d8-4af7-9a4e-a8775b047380",
"type": "about:blank"
}Authorizations
API token created in the dashboard under Integrations > API. Tokens start with gci_.
Path Parameters
Pattern:
[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}Body
application/json
Identifiers of the players online right now, such as nicknames. Up to 4,096 after trimming and lowercasing. Commands that require the player online only run for identifiers in this list.
Example:
["Steve", "Alex"]
Was this page helpful?
