HyperTrackDocs
Authentication

Secure embed view

POST
/oauth/embed-token

Exchange an order detail view URL for a short-lived secure URL with an endpoint-restricted access token appended. The order must exist and have an associated device. This endpoint is not a general-purpose exchange for arbitrary dashboard or list-view URLs. Authenticate with HTTP Basic auth using your account ID and secret key. Use the returned secure_embed_url as the iframe source without changing its query parameters.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/oauth/embed-token" \  -H "Content-Type: application/json" \  -d '{    "embed_url": "https://embed.hypertrack.com/orders/my_order_handle?fulfillment_attempt=0&show-visits-only=true",    "grant_type": "client_credentials"  }'
{  "access_token": "string",  "token_type": "Bearer",  "expires_in": 0,  "embed_url": "string",  "secure_embed_url": "string"}
Empty
Empty
Empty