Skip to main content

Puntos de conexión de usuarios

Parámetros y puntos de conexión de los usuarios

Para obtener más información sobre las relaciones entre objetos, ve a la sección Relaciones entre objetos.

Para obtener más información sobre usuarios, visita la página de ayuda Administración de usuarios y grupos.

Create a New Subscription

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

Nota

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 "".

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": ""
}'
  • 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.

Nota

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.

curl -X 'GET' \
  'http://localhost/webapi/v3/subscriptions?userCountGreaterThanEquals=1&workflowCountGreaterThanEquals=3' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 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.

Nota

This endpoint is for Curators (Server admins) only.

Parameters

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

curl -X 'GET' \
  'http://localhost/webapi/v3/subscriptions/66ebd0896e52ae73b495106f' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 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.

Nota

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.

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
}'
  • 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.

Nota

This endpoint is for Curators (Server admins) only.

Parameters

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

curl -X 'DELETE' \
  'http://localhost/webapi/v3/subscriptions?subscriptionId=66ec22e86e52ae73b49510a1' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 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.

Nota

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.

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"
  ]
}'
  • 200: OK

  • 400: BadRequest

  • 401: Unauthorized

  • 404: NotFound

Relaciones entre objetos

Si creas un usuario, puedes utilizar los objetos creados de la siguiente manera:

Objeto creado: “id” (por ejemplo, “id”: “619158e57e607d0011ac3009”)

Puedes usarlo como:

Ejemplos de solicitudes de Postman

GET /v3/users

Postman_subscriptions_get2.png

GET /v3/users/{id}/assets

Postman_subscriptions_get.png

Para obtener más información sobre las solicitudes de Postman, visita la página de ayuda Cómo usar Postman.