Benutzer-Endpunkte

Benutzer-Endpunkte und Parameter

Neuen Benutzer erstellen
Bestimmten Benutzer suchen
Search for a Specific Subscription
Update an Existing Subscription
Benutzer löschen
Change a User's Subscription

Weitere Informationen zu den Objektbeziehungen finden Sie im Abschnitt Objektbeziehungen.

Weitere Informationen über Benutzer finden Sie auf der Hilfeseite Benutzer- und Gruppenverwaltung.

Create a New Subscription

To create a new subscription, use the POST {baseURL}/v3/subscriptions endpoint.

Anmerkung

This endpoint is for Curators (Server admins) only.

Parameters

contract (body): To create a new subscription, the contract parameter is required. Specify the following parameters:

name (string): Required. Enter a name for the new subscription.
canShareSchedule (Boolean): Required. Specify whether shared schedules will be enabled the subscription you are creating.
credentialId (string): Required. This parameter refers to the unique ID of a credential, assigned to the user as default. When not specified, the default is "".

Request Example: cURL

curl -X 'POST' \
  'http://localhost/webapi/v3/subscriptions' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "New Studio",
  "canShareSchedule": true,
  "credentialId": ""
}'

Response Example

200: OK

201: Created

{
  "name": "string",
  "apiKey": "string",
  "apiSecret": "string",
  "active": true,
  "expirationDate": "string",
  "expDate": "2024-09-19T13:13:44.245Z",
  "dateUpdated": "2024-09-19T13:13:44.245Z",
  "apiEnabled": true,
  "canShareSchedules": true,
  "credentialId": "string",
  "credentials": [
    {
      "credentialId": "string",
      "id": "string"
    }
  ],
  "dataConnections": [
    {
      "dataConnectionId": "string",
      "id": "string"
    }
  ],
  "id": "string"
}

400: BadRequest
401: Unauthorized
404: NotFound

Retrieve All Subscriptions

To retrieve details about all subscriptions, use the GET {baseURL}/v3/subscriptions endpoint. Use various parameters as a filter for searching the subscriptions.

Anmerkung

This endpoint is for Curators (Server admins) only.

Parameters

name (string): Optional. To search for a specific subscription, enter the name of this subscription.
canShareSchedules (Boolean): Optional. Select whether shared schedules are enabled for the subscriptions you are searching for.
defaultWorkflowCredentialId (string): Optional. Enter a default workflow credential ID for the subscriptions you are searching for.
userCountGreaterThanEquals (int32): Specify how many users should be in the subscription you are looking for, more or equal to the specified number.
workflowCountGreaterThanEquals (int32): Specify how many workflows should be in the subscription you are looking for, more or equal to the specified number.
workflowCountLessThanEquals (int32): Specify how many workflows should be in the subscription you are looking for, more or equal to the specified number.

Request Example: cURL

curl -X 'GET' \
  'http://localhost/webapi/v3/subscriptions?userCountGreaterThanEquals=1&workflowCountGreaterThanEquals=3' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'

Response Example

200: OK

[
  {
    "userCount": 0,
    "workflowCount": 0,
    "id": "string",
    "name": "string",
    "credentialId": "string",
    "canShareSchedules": true
  }
]

401: Unauthorized

Search for a Specific Subscription

To search for a specific subscription, use the GET {baseURL}/v3/subscriptions/{subscriptionId} endpoint.

Anmerkung

This endpoint is for Curators (Server admins) only.

Parameters

subscriptionsId (string): Required. Enter a subscription ID to retrieve information about this subscription.

Request Example: cURL

curl -X 'GET' \
  'http://localhost/webapi/v3/subscriptions/66ebd0896e52ae73b495106f' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'

Response Example

200: OK

  "users": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "workflows": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "id": "string",
  "name": "string",
  "credentialId": "string",
  "canShareSchedules": true
}

401: Unauthorized
404: NotFound

Update an Existing Subscription

To update an existing subscription, use the PUT {baseURL}/v3/subscription/{subscriptionId} endpoint.

Anmerkung

This endpoint is for Curators (Server admins) only.

Parameters

subscriptionId (string): Required. Enter a subscription ID to get this subscription updated.
subscription (body): Required. To update a subscription, the updateContract parameter is required. Specify the following:
- name (string): Required. Enter a new name for the subscription.
- credentialId (string): Required. This parameter refers to the unique ID of a credential, assigned to the user as default. When not specified, the default is "".
- canShareSchedules (Boolean): Required. Specify whether shared schedules will be enabled the subscription you are updating.

Request Example: cURL

curl -X 'PUT' \
  'http://localhost/webapi/v3/subscriptions/66ebd0896e52ae73b495106f' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Doe'\''s Studio",
  "credentialId": "",
  "canShareSchedules": false
}'

Response Example

200: OK

{
  "id": "string",
  "name": "string",
  "credentialId": "string",
  "canShareSchedules": true
}

400: BadRequest
401: Unauthorized
404: NotFound

Delete a Subscription

To delete a specific subscription from the system, use the DELETE {baseURL}/v3/subscriptions endpoint.

Anmerkung

This endpoint is for Curators (Server admins) only.

Parameters

subscriptionId (string): Required. Enter the subscription ID you want to delete.

Request Example: cURL

curl -X 'DELETE' \
  'http://localhost/webapi/v3/subscriptions?subscriptionId=66ec22e86e52ae73b49510a1' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'

Response Example

200: OK
400: BadRequest
401: Unauthorized
404: NotFound

Change a User’s Subscription

To move a user (or multiple users) from one subscription to another, use the PUT {baseURL}/v3/subscriptions/{subscriptionId}/users endpoint.

Anmerkung

This endpoint is for Curators (Server admins) only.

Parameters

subscriptionId (string): Required. Enter an existing subscription ID you want to move the user to.
contract (body):
- userIds (string): Enter user IDs you want to move under the specified subscriptionId.

Request Example: cURL

curl -X 'PUT' \
  'http://localhost/webapi/v3/subscriptions/66ffbb75125b93320a8bb5c7/users' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "userIds": [
    "66ffbb4b125b93320a8bb5bd"
  ]
}'

Response Example

200: OK
400: BadRequest
401: Unauthorized
404: NotFound

Objektbeziehungen

Wenn Sie einen Benutzer erstellen, können Sie erstellte Objekte wie folgt verwenden:

Erstelltes Objekt: „id“ (z. B. "id": "619158e57e607d0011ac3009")

Sie können sie wie folgt verwenden:

userId, wenn Sie Benutzer zu einer Benutzergruppe hinzufügen.
subscriptionId if you want to update an existing subscription.
subscriptionId if you want to delete an existing subscription.
subscriptionId if you want to move a user (or multiple users) from one subscription to another.

Beispiele für eine Postman-Anforderung

GET /v3/users

GET /v3/users/{id}/assets

Weitere Informationen zu Postman-Anforderungen finden Sie auf der Hilfeseite Postman verwenden.

In diesem Abschnitt:

Benutzer-Endpunkte