Search

How to use API v2

Access tokens for the public API v2 can be created through your Emply’s website.

To perform API calls: use Swagger or generate an API Client from the OpenAPI Description file.

The list of tools for generating API clients: OpenAPI.Tools

Create new access tokens

Follow these steps to create a new access token

  1. In your Emply instance, go to Settings+Integrations.

  2. Click API2, and then New Shared Access Token

    Emply_API2_menu.png
  3. Specify the internal title, and the access rights that should be granted through the token.

    Emply_API2_Generate_token.png

    Anmerkung

    If you have a specific endpoint in mind, you can see which area it belong to and what type of access is required for it in Swagger UI.

    Emply_API2_Generate_access_endpoint.png
  4. Click on Generate and copy the token using the copy icon copy_button.png.

You can Deactivate or Revoke the token at a later point in time. A deactivated token can be re-activated later, but a revoked token can no longer be used. You can also add/modify IP restrictions for the token usage.

Anmerkung

Note the that token has a format of JSON Web Token, that means a developer can apply a base64 decoding, to see what information it carries.

JWT_Decoder.png

War dieser Beitrag hilfreich?

War dieser Beitrag hilfreich?

Möchten Sie Kontakt aufnehmen?

Wir helfen Ihnen. Füllen Sie eine Anfrage aus und wir melden uns so schnell wie möglich bei Ihnen.

Eine Anfrage einreichen