Measure MapAPI
Help CenterGet an API key

Create an embed token

POST/auth/iframe/token
auth EnterpriseOpen Guest

A token for one embed, valid for 60 minutes. Your server asks for one before it writes the page, and puts it in the iframe's address instead of your key:

Text
https://app.measuremaponline.com/iframe_api?pid=PROJECT_ID&token=TOKEN

Use Create an access token when you need a different lifetime.

Responses

  • EmbedToken:

    • tokenstringrequired
      The token. It works for 60 minutes.
    • environmentstringrequired
      Which world the key, and everything made with it, belongs to. See Live and sandbox.
      One oflivesandbox

Errors

A failed request answers with one of these, in an Error body.

401unauthorized_actionThe item is not on your account or your members', the request came from a web page on a website the key does not allow, or the action is not allowed for this person.
403api_key_suspendedAPI access on your account has been suspended. Contact support.
403insufficient_scopeThe key does not have the access this endpoint needs. Create a key with that access.
403invalid_api_keyNo key was sent in the Authorization header, or the key is unknown, revoked, or past the time it kept working after being replaced.
403invalid_subscriptionYour plan has no API access. The API is part of the Enterprise and Open Guest plans.
403subscription_expiredYour subscription is not active. Update your payment method in the app.
429too_many_requestsYour account asked for more than 600 tokens in an hour. Wait a little and try again.

Try it

This key is

The key stays in this tab and goes only to the API. Use a sandbox key while you try things: requests are real, and what they change is changed.

POST https://api.measuremaponline.com/api/v1/auth/iframe/token

Fill in your API key to send.

As a cURL command
Shell
curl -X POST 'https://api.measuremaponline.com/api/v1/auth/iframe/token' \
  -H "Authorization: $MMO_API_KEY"