Kimlik bilgilerinizin kullanıcı adını ve sırrını belirteç uç noktasına gönderin. Bu borsanın hamiline ait bir tokena ihtiyacı yoktur. Döndürülen erişim belirtecini sonraki REST isteklerinde taşıyıcı belirteç olarak kullanın.
password: Bu JSON alanı, hesabınızın oturum açma şifresini değil, API kimlik bilgilerinin sırrını taşır.
İlk isteğinizi yapın
Örneği yerel olarak çalıştırın. Kimlik bilgilerinizi ister, bir erişim belirteci alır ve cihazların ilk sayfasını listeler. Belirteci gizli tutun. Bu belge sayfaları hiçbir zaman kimlik bilgilerini istemez veya saklamaz.
Bir dil seçin ve aşağıda listelenen bağımlılıkları yükleyin. Örneklerde Cloud API adresi kullanılmaktadır. Hiçbir zaman gerçek sırları belgelere, destek biletlerine veya paylaşılan günlüklere yapıştırmayın.
cURL: Bash + jq · Python: requests · C#: .NET 8+ (HttpClient)
C#: dotnet new console → Program.cs → dotnet run
$credential = Get-Credential
$body = @{
username = $credential.UserName
password = $credential.GetNetworkCredential().Password
audience = "api"
} | ConvertTo-Json
$token = Invoke-RestMethod -Method Post -Uri "https://api.remotegymp.com/v1/auth/token" -ContentType "application/json" -Body $body
$env:RG_API_TOKEN = $token.accessToken
Invoke-RestMethod -Uri "https://api.remotegymp.com/v1/devices?pageSize=25" -Headers @{ Authorization = "Bearer $env:RG_API_TOKEN" }Erişim belirteci yanıtı
Kimlik bilgileri değişimi aşağıdaki alanları döndürür. Burada gösterilen jeton bir yer tutucudur. Kullanım ömrü saniye cinsindendir ve son kullanma zaman damgası UTC'dir.
{
"accessToken": "<access-token>",
"tokenType": "Bearer",
"expiresIn": 1800,
"expiresAtUtc": "2026-10-26T12:30:00Z"
}Kimlik bilgileri ile verilen jetonların süresi 30 dakikadır. Bu değişim bir yenileme belirteci döndürmez. Belirtecin süresi dolduğunda kimlik bilgilerini yeniden değiştirin. Kesintiye uğrayan bir yazma için, yeniden göndermeden önce sonucunu ve uç noktanın yeniden deneme kurallarını kontrol edin.
Erişim belirtecinin nerede kullanılabileceğini seçin
audience: "api"- REST API istekleri için bu değeri kullanın. Hedef kitle alanı atlandığında varsayılan değerdir.
audience: "mcp"- Bu değeri yalnızca taşıyıcı jetonla yapılandırılmış bir MCP istemcisi için kullanın. Kimlik bilgileri MCP'yi etkinleştirmiş olmalıdır. API ve MCP tokenleri birbirinin yerine kullanılamaz.
Kimlik doğrulama başarısız olursa
- 401
- Kullanıcı adını ve sırrı, kimlik bilgilerinin geçerlilik süresini ve iptalini kontrol edin. Kimliği doğrulanmış bir istek üzerine, belirtecin geçerlilik süresini ve hedef kitlesini de kontrol edin. Aynı geçersiz kimlik bilgilerinin tekrarlanması sorunu çözmez.
- 403
- Yanıt kodunu ve mesajı kontrol edin. Erişim izinler, ağ veya ülke politikası, Sahibin mevcut erişimi veya eklenti uygunluğu nedeniyle engellenebilir. Yeni bir token bu kontrolleri atlamaz.
- 429 ·
Retry-After - Tekrar denemeden önce yanıt başlığında belirtilen gecikmeyi bekleyin. Varsayılan belirteç denemesi sınırı, her Aktarıcıda kaynak IP başına dakika başına 10'dur. Platform ayarları bu sınırı değiştirebilir.