Πιστοποίηση

Στείλτε το όνομα χρήστη και το μυστικό του διαπιστευτηρίου σας στο τελικό σημείο του διακριτικού. Αυτή η ανταλλαγή δεν χρειάζεται διακριτικό κομιστή. Χρησιμοποιήστε το επιστρεφόμενο διακριτικό πρόσβασης ως διακριτικό κομιστή σε επόμενα αιτήματα REST.

password: Αυτό το πεδίο JSON φέρει το μυστικό διαπιστευτηρίων API, όχι τον κωδικό πρόσβασης σύνδεσης του λογαριασμού σας.

Κάντε το πρώτο σας αίτημα

Εκτελέστε το παράδειγμα τοπικά. Σας ζητά τα διαπιστευτήριά σας, λαμβάνει ένα διακριτικό πρόσβασης και παραθέτει την πρώτη σελίδα των συσκευών. Κρατήστε το διακριτικό ιδιωτικό. Αυτές οι σελίδες τεκμηρίωσης δεν ζητούν και δεν αποθηκεύουν ποτέ διαπιστευτήρια.

Επιλέξτε μια γλώσσα και εγκαταστήστε τις εξαρτήσεις που αναφέρονται παρακάτω. Τα παραδείγματα χρησιμοποιούν τη διεύθυνση Cloud API. Ποτέ μην επικολλάτε πραγματικά μυστικά σε τεκμηρίωση, εισιτήρια υποστήριξης ή κοινόχρηστα αρχεία καταγραφής.

$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" }

Πρόσβαση σε απάντηση διακριτικού

Η ανταλλαγή διαπιστευτηρίων επιστρέφει τα παρακάτω πεδία. Το διακριτικό που εμφανίζεται εδώ είναι ένα σύμβολο κράτησης θέσης. Η διάρκεια ζωής είναι σε δευτερόλεπτα και η χρονική σήμανση λήξης είναι UTC.

{
  "accessToken": "<access-token>",
  "tokenType": "Bearer",
  "expiresIn": 1800,
  "expiresAtUtc": "2026-10-26T12:30:00Z"
}

Τα διαπιστευτήρια που εκδίδονται διαρκούν 30 λεπτά. Αυτή η ανταλλαγή δεν επιστρέφει διακριτικό ανανέωσης. Όταν λήξει ένα διακριτικό, ανταλλάξτε ξανά τα διαπιστευτήρια. Για μια διακεκομμένη εγγραφή, ελέγξτε το αποτέλεσμά της και τους κανόνες επανάληψης του τελικού σημείου πριν την υποβάλετε ξανά.

Επιλέξτε πού μπορεί να χρησιμοποιηθεί το διακριτικό πρόσβασης

audience: "api"

Χρησιμοποιήστε αυτήν την τιμή για αιτήματα REST API. Είναι η προεπιλογή όταν παραλείπεται το πεδίο κοινού.

audience: "mcp"

Χρησιμοποιήστε αυτήν την τιμή μόνο για έναν πελάτη MCP που έχει διαμορφωθεί με διακριτικό φορέα. Το διαπιστευτήριο πρέπει να έχει ενεργοποιημένο το MCP. Τα διακριτικά API και MCP δεν μπορούν να χρησιμοποιηθούν εναλλακτικά.

Εάν ο έλεγχος ταυτότητας αποτύχει

401

Ελέγξτε το όνομα χρήστη και το μυστικό, τη λήξη διαπιστευτηρίων και την ανάκληση. Σε ένα επικυρωμένο αίτημα, ελέγξτε επίσης τη λήξη του διακριτικού και το κοινό. Η επανάληψη των ίδιων μη έγκυρων διαπιστευτηρίων δεν θα επιλύσει το πρόβλημα.

403

Ελέγξτε τον κωδικό απάντησης και το μήνυμα. Η πρόσβαση μπορεί να αποκλειστεί από τα δικαιώματα, την πολιτική δικτύου ή χώρας, την τρέχουσα πρόσβαση του Κατόχου ή την καταλληλότητα των πρόσθετων. Ένα νέο διακριτικό δεν παρακάμπτει αυτούς τους ελέγχους.

429 · Retry-After

Περιμένετε την καθυστέρηση που δίνεται στην κεφαλίδα απόκρισης πριν προσπαθήσετε ξανά. Το προεπιλεγμένο όριο προσπάθειας διακριτικού είναι 10 ανά IP πηγής ανά λεπτό σε κάθε Ρελέ. Οι ρυθμίσεις πλατφόρμας μπορούν να αλλάξουν αυτό το όριο.

Αναφορά API → POST /v1/auth/token

Συνδέστε έναν βοηθό AI →