API Docs

1Data Gateway uses RESTful APIs which are publicly accessible and secured using keys. See API Submissions for information on managing Submissions with the API.

Administrators can find a link to the Swagger docs via the Help and Support page in 1Data Gateway.

All users are able to access the APIs but Submission management and assignments are limited to the submission owner/creator.

All users can create submissions if it is part of their assignment and they have an API key.

All authenticated API endpoints require the client to provide an API Key via HTTP Bearer authentication.

     Note: Unless noted, the API request and response bodies are in JSON format.

ClosedAPI Keys

API Keys are required on a per User basis and are necessary for authentication of the API endpoints.

All API Keys must be created individually but can be created by an administrator on behalf of Users or by the User themselves. The process is the same but is accessed from different pages.

Administrators can use the API Key tab of Users to create and manage API Keys on Users behalves.

Users can create and mange their own API Keys from the API Key tab when Managing Your Account.

     Note: The key becomes invalid if it passes the expiry date or the User's account becomes disabled.

     Note: For security purposes we recommend that keys are carefully managed and only supplied to trusted individuals.

From the API keys tab click the Add button to create a new API Key.

API keys tab with an example key listed.

Fill in the name, description, and expiry date, and then click the Add API Key button.

Add API key popout requiring a name, description, and an expiration.

Copy the API key with the Copy button and click Continue when you've stored the key somewhere safe.

An example generated API key, which warns to write it down as it cannot be viewed again.

API Keys can be edited or removed:

Click the Edit button to edit and update the API settings.

API Key Settings popout allowing the key details to be edited.

Click the Remove button , then confirm with the Remove button to remove an API Key.

Remove API Key popout, asking for removal confirmation.

ClosedAnalytics

The 1Data Gateway API can be leveraged to perform analytics in external applications.

The following API calls can be used for Specification reports on:

  • Rule conformance over time.

  • /api/v1/reports/specification/{specificationKey}/rule_conformance

  • Submissions over time.

  • /api/v1/reports/specification/{specificationKey}/submissions

  • Task performance over time.

  • /api/v1/reports/specification/{specificationKey}/task_conformance

    Replace the {specificationKey} with the Specification Key found in the Specifications.