Endpoint REST API

GET /api/me

Πλαίσιο λογαριασμού με κλειδί API: ο τρέχων tracker και όλα τα tracker στα οποία έχει πρόσβαση το token.

Αίτημα

GET https://api.nowmetrix.com/api/me

Ξεκινήστε από εδώ όταν μια ενσωμάτωση χρειάζεται να εντοπίσει σε ποια tracker έχει πρόσβαση το κλειδί API, πριν υποβάλει αιτήματα για συγκεκριμένο tracker.

Έλεγχος ταυτότητας

Απαιτείται κλειδί API στην κεφαλίδα Authorization με την τιμή Authorization: Bearer nm_YOUR_KEY.

Παράμετροι ερωτήματος

Αυτό το endpoint δεν δέχεται παραμέτρους ερωτήματος.

Παράδειγμα cURL

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/api/me"

Παράδειγμα απόκρισης

{
  "authenticated": true,
  "current_tracker": "TRACKER_ID",
  "trackers": [
    {
      "tracker": "TRACKER_ID",
      "host": "example-media.test"
    },
    {
      "tracker": "SECOND_TRACKER_ID",
      "host": "example-studio.test"
    }
  ]
}

Πεδία απόκρισης

Πεδίο Τύπος Περιγραφή
authenticated boolean Υποδεικνύει αν το Bearer token είναι έγκυρο.
current_tracker string Το πρώτο tracker που είναι διαθέσιμο στο κλειδί API. Χρησιμοποιήστε τα αναγνωριστικά tracker από τον πίνακα trackers για αιτήματα που αφορούν συγκεκριμένο tracker.
trackers[] array<object> Τα tracker που είναι διαθέσιμα στον τρέχοντα χρήστη.
trackers[].tracker string Αναγνωριστικό tracker.
trackers[].host string Κανονικοποιημένο όνομα host για το tracker.

Επικαιρότητα και προσωρινή αποθήκευση

Οι αποκρίσεις δεν αποθηκεύονται προσωρινά. Το endpoint αποστέλλει την κεφαλίδα Cache-Control: no-store, no-cache, must-revalidate, max-age=0.

Σφάλματα

HTTP Κωδικός Περιγραφή
401 missing_token Λείπει η κεφαλίδα Authorization.
401 invalid_token Το token δεν είναι έγκυρο ή έχει ανακληθεί.
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}