Endpoint delle pianificazioni

Endpoint e parametri delle programmazioni

Per ulteriori informazioni sulle relazioni tra oggetti e su come utilizzarle nell'API, consulta la sezione Relazioni tra oggetti .

Per ulteriori informazioni sui fusi orari validi che è possibile specificare durante l'uso degli endpoint delle pianificazioni GET e PUT, consulta la sezione Fusi orari.

Per ulteriori informazioni sulle pianificazioni, consulta la pagina di assistenza Pianificazioni: interfaccia di amministrazione.

Creazione di una nuova pianificazione

Per creare una nuova pianificazione, utilizza l'endpoint POST {baseURL}/v3/schedules.

Nota

Solo gli amministratori possono usare questo endpoint API. Se il parametro timeZone è vuoto o è stato ignorato, tutti i campi Data e ora corrispondono al fuso orario UTC-0. Se il parametro timeZone è specificato, tutti i campi Data e ora corrispondono al fuso orario specificato. Per visualizzare l'elenco dei fusi orari validi, consulta la sezione Fusi orari .

If timeZone is empty or skipped, all Date Time fields will correspond to the UTC-0 timezone. If the timeZone is specified, all the Date Time fields will correspond to the specified timezone. To view the list of valid timezones, go to Timezones.

Parametri

contract (corpo): il parametro contract è obbligatorio per creare una nuova pianificazione. Specifica i seguenti parametri:
- workflowId (stringa): immetti l'ID di un flusso di lavoro che desideri pianificare.
- iteration (corpo):
  - iterationType (stringa): specifica la frequenza di pianificazione del flusso di lavoro ("Once", "Hourly", "Daily", "Weekly", "Monthly" e "Custom"). Non dimenticare di specificare la frequenza oraria ( hourlyContract ), giornaliera ( dailyContract ), settimanale ( weeklyContract ), mensile ( monthlyContract ) o personalizzata ( customContract ) del rispettivo tipo di iterazione. Per ulteriori informazioni, consulta la pagina di assistenza Pianificazione di un flusso di lavoro .
  - startTime (stringa): obbligatorio. Immetti una data e un'ora specifiche per l'esecuzione del flusso di lavoro. La data di inizio deve essere successiva a quella corrente.
  - endTime (stringa): opzionale. Immetti la data e l'ora esatte in cui l'esecuzione del flusso di lavoro deve terminare.
  - hourlyContract (corpo): opzionale. Da utilizzare se per iterationType è stato specificato "Hourly".
    hours (stringa): specifica l'ora.
    minutes (stringa): specifica i minuti.
  - dailyContract (corpo): opzionale. Da utilizzare se per iterationType è stato specificato "Daily".
    runOnlyWorkWeek (booleano): opzionale. In assenza di specifica, l'impostazione predefinita è false.
  - weeklyContract (corpo): opzionale. Da utilizzare se per iterationType è stato specificato "Weekly".
    daysOfWeek (stringa): specifica il giorno della settimana in cui eseguire il flusso di lavoro. Ad esempio, "Domenica".
  - monthlyContract (corpo): opzionale. Da utilizzare se per iterationType è stato specificato "Monthly".
    simpleDayOfMonth (booleano): immetti "true" se desideri specificare un giorno del mese in cui eseguire il flusso di lavoro.
    dayOfMonth (stringa): immetti il numero del giorno del mese in cui desideri eseguire il flusso di lavoro. Ad esempio, immetti "1" per il primo giorno del mese.
    occurrence (stringa): immetti una delle seguenti opzioni se desideri eseguire il flusso di lavoro, ad esempio, la prima domenica del mese. I valori accettabili sono: "1" (prima ricorrenza), "2" (seconda ricorrenza), "3" (terza ricorrenza), "4" (quarta ricorrenza) e "-1" (ultima ricorrenza del mese).
    dayOfWeek (stringa): specifica il giorno della settimana in cui eseguire il flusso di lavoro. Ad esempio, per specificare domenica immetti "0" o "Sunday".
  - customContract (corpo): opzionale. Da utilizzare se per iterationType è stato specificato "Custom".
    daysOfMonth (array): specifica i giorni del mese in cui eseguire il flusso di lavoro. Ad esempio, [1, 15, 28].
    months (array): specifica il mese in cui eseguire il flusso di lavoro. Ad esempio, [1, 5, 7, 9, 12].
name (stringa): opzionale. Immetti il nome della pianificazione.
comment (stringa): opzionale. Immetti un commento, se necessario.
priority (stringa): opzionale. Specifica la priorità per l'esecuzione della pianificazione. Scegli tra le seguenti opzioni: "Low", "Medium", "High" e "Critical". In assenza di specifica, il valore predefinito sarà "Low".
workerTag (stringa): opzionale. Specifica il worker assegnato. In assenza di specifica, il valore sarà "none".
credentialId (stringa): opzionale.
timeZone (stringa): opzionale. Specifica il fuso orario in cui creare la pianificazione. Per ulteriori informazioni sui fusi orari validi, consulta la sezione Fusi orari .
Esempio: "timeZone": "Etc/GMT+4"
questions (body): Optional. For an analytic app, specify the parameters the schedule will run with.
- name (string): Enter the name of the Interface Tool used in the analytic app. For example, from the XML of the analytic app “<Question><Name>Text Box (10)</Name>”, the name is “Text Box (10)”.
- value (string): Enter the answer to the Interface Tool.

Request Example: cURL

Example of a request to create a schedule with the following occurrence - once, with a start and end time specified:

curl -X 'POST' \
  'http://localhost/webapi/v3/schedules' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "workflowId": "5555555555555eeeeee6666",
  "iteration": {
    "iterationType": "Once",
    "startTime": "2024-10-09T13:44:15.771Z",
    "endTime": "2024-10-10T13:44:15.771Z"
  },
  "name": "Once_October",
  "comment": "Only once in Oct 2024",
  "priority": "Default",
  "workerTag": "",
  "credentialId": ""
}'

Example of a request to create a schedule with hourly occurrence:

curl -X 'POST' \
  'http://localhost/webapi/v3/schedules' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "workflowId": "444444444edslfksldkfjsldf9",
  "iteration": {
    "iterationType": "Hourly",
    "startTime": "2024-10-10T13:44:15.771Z",
    "endTime": "2024-10-12T13:44:15.771Z",
    "hourlyContract": {
      "hours": 1,
      "minutes": 15
    }
  },
  "name": "Hourly",
  "comment": "Testing",
  "priority": "Default",
  "workerTag": "",
  "credentialId": ""
}
'

Example of a request to create a schedule with weekly occurrence:

curl -X 'POST' \
  'http://localhost/webapi/v3/schedules' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "workflowId": "333333klkslfkdjslfkde444",
  "iteration": {
    "iterationType": "Weekly",
    "startTime": "2024-10-10T13:44:15.771Z",
    "endTime": "2025-10-12T13:44:15.771Z",
    "weeklyContract": {
      "daysOfWeek": [
      "Sunday" ]
    }
  },
  "name": "Weekly",
  "comment": "For 2024 and 2025",
  "priority": "Default",
  "workerTag": "",
  "credentialId": ""
}
'

Example of a request to create a schedule with monthly occurrence - 2nd Sunday of every month:

curl -X 'POST' \
  'http://localhost/webapi/v3/schedules' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "workflowId": "222222efklskdfjsldk111",
  "iteration": {
    "iterationType": "Monthly",
    "startTime": "2024-10-10T13:44:15.771Z",
    "endTime": "2025-10-12T13:44:15.771Z",
    "monthlyContract": {
      "simpleDayOfMonth": false,
      "occurence": 2,
      "dayNumber": "Sunday"
    }
  },
  "name": "Monthly Schedule",
  "comment": "2nd week of a month",
  "priority": "Default",
  "workerTag": "",
  "credentialId": ""
}'

Example of a request to create a schedule with monthly occurrence - every 15th day of the month:

curl -X 'POST' \
  'http://localhost/webapi/v3/schedules' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "workflowId": "61sersfs59lskdfsl345",
  "iteration": {
    "iterationType": "Monthly",
    "startTime": "2024-10-10T13:44:15.771Z",
    "endTime": "2025-10-12T13:44:15.771Z",
    "monthlyContract": {
      "simpleDayOfMonth": true,
      "dayOfMonth": 15
    }
  },
  "name": "Monthly Schedule 2",
  "comment": "every 15th",
  "priority": "Low",
  "workerTag": "",
  "credentialId": ""
}'

Example of a request to create a custom schedule:

curl -X 'POST' \
  'http://localhost/webapi/v3/schedules' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "workflowId": "787899864sfgsjsldkfs45",
  "iteration": {
    "iterationType": "Custom",
    "startTime": "2024-10-10T13:44:15.771Z",
    "endTime": "2025-10-12T13:44:15.771Z",
    "customContract": {
      "daysOfMonth": [1,2,5,6,9,12,15,21,23,25],
      "months": [1,2,6,7,11,12]
    }
  },
  "name": "Custom Schedule 2",
  "comment": "every 15th",
  "priority": "Low",
  "workerTag": "",
  "credentialId": ""
}'

Response Example

201: Identifier for the new schedule
```
"string"
```
400: BadRequest
401: Unauthorized

Richiesta di informazioni su tutte le pianificazioni

Per chiedere informazioni su tutte le pianificazioni, utilizza l'endpoint GET {baseURL}/v3/schedules. Utilizza vari parametri per filtrare le pianificazioni che desideri visualizzare.

Nota

Curators receive information about all schedules for all workflows and analytic apps.
All other users are able to get information about schedules for workflows and analytic apps they have both access to and permission for, either through studio or collection permissions.
When you filter schedules using runsAfter and runsBefore, you are limited to 45 days apart from each other.
Due to changes we have made to the service timestamps, all date and time fields in the response will be returned in UTC-0 timezone. To view the list of valid timezones, go to Timezones.

Parametri

view (stringa): opzionale. È possibile non specificare alcun valore o selezionare "Default" e "Full". Se il parametro è impostato su "Default", viene restituito un oggetto vista ridotto. Se non è specificato alcun valore, viene utilizzato "Default".
ownerId (stringa): opzionale. Immetti l'ID del proprietario in base al quale desideri filtrare la pianificazione.
workflowId (stringa): opzionale. Immetti l'ID del flusso di lavoro in base al quale desideri filtrare la pianificazione.
runsAfter (data-ora): opzionale. Immetti la data e l'ora dopo le quali eseguire la pianificazione. Immetti la data e l'ora in formato ISO8601 .
runsBefore (data-ora): opzionale. Immetti la data e l'ora prima delle quali eseguire la pianificazione. Immetti la data e l'ora in formato ISO8601 .

Esempio di richiesta: cURL

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

Response Example

200: OK

[
  {
    "id": "string",
    "name": "string",
    "workflowId": "string",
    "ownerId": "string",
    "runDateTime": "string",
    "timeZone": "string"
  }
]

400: BadRequest
401: Unauthorized

Ricerca di una pianificazione specifica

Per recuperare i dettagli di una pianificazione esistente, utilizza l'endpoint GET {baseURL}/v3/schedules/{scheduleId}.

Nota

Curators and users are able to retrieve details about schedules for workflows and analytic apps they have both access to and permission for, either through studio or collection permissions.
If the schedule is for an analytic app, then the owner of the schedule is able to view the analytic app wizard values originally defined.
Due to changes we have made to the service timestamps, all date and time fields in the response will be returned in UTC-0 timezone. To view the list of valid timezones, go to Timezones.

Parametri

scheduleId (string): Required. Enter a schedule ID to retrieve information about this schedule.

Esempio di richiesta: cURL

curl -X 'GET' \
  'http://localhost/webapi/v3/schedules/670ce5fb5073000030000b8e' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'

Response Example

200: OK

{
  "id": "string",
  "name": "string",
  "workflowId": "string",
  "versionId": "string",
  "ownerId": "string",
  "runDateTime": "string",
  "comment": "string",
  "enabled": true,
  "priority": "Default",
  "workerTag": "string",
  "status": "string",
  "credentialId": "string",
  "creationTime": "string",
  "lastRunTime": "string",
  "state": "string",
  "runCount": 0,
  "iteration": {
    "startTime": "string",
    "endTime": "string"
  },
  "frequency": "string",
  "lastError": "string",
  "cpuName": "string",
  "lastModifiedId": "string",
  "lastModifiedDate": "string",
  "canEdit": true,
  "timeZone": "string",
  "questions": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}

401: Unauthorized
404: NotFound

Aggiornamento di una pianificazione esistente

Per aggiornare i dettagli di una pianificazione esistente, utilizza l'endpoint PUT {baseURL}/v3/schedules/{scheduleId}.

Nota

The following users can update schedules:
- Curators can update all workflows and analytic app schedules, including the analytic app wizard values.
- Schedule owners can update their workflows and analytic app schedules, including analytic app wizard values.
- Users are able to update schedules for workflows and analytic apps they have both access to and permission for, either through studio or collection permissions. They cannot update the wizard values of analytic app schedules.
If timeZone is empty or skipped, all Date Time fields will correspond to the UTC-0 timezone. If the timeZone is specified, all the Date Time fields will correspond to the specified timezone. To view the list of valid timezones, go to Timezones.

Parametri

scheduleId (stringa): obbligatorio. Immetti l'ID di una pianificazione affinché venga aggiornata.
contract (corpo): obbligatorio. Il parametro contract è obbligatorio per aggiornare una pianificazione. Specifica quanto segue:
- workflowId (stringa): obbligatorio. Immetti l'ID di un flusso di lavoro.
- ownerId (stringa): obbligatorio. Immetti l'ID di un utente.
- iteration (corpo):
  - iterationType (stringa): specifica la frequenza di pianificazione del flusso di lavoro ("Once", "Hourly", "Daily", "Weekly", "Monthly" e "Custom"). Non dimenticare di specificare la frequenza oraria ( hourlyContract ), giornaliera ( dailyContract ), settimanale ( weeklyContract ), mensile ( monthlyContract ) o personalizzata ( customContract ) del rispettivo tipo di iterazione. Per ulteriori informazioni, consulta la pagina di assistenza Pianificazione di un flusso di lavoro .
  - startTime (stringa): obbligatorio. Immetti una data e un'ora specifiche per l'esecuzione del flusso di lavoro. La data di inizio deve essere successiva a quella corrente.
  - endTime (stringa): obbligatorio. Immetti la data e l'ora esatte in cui l'esecuzione del flusso di lavoro deve terminare.
  - hourlyContract (corpo): opzionale. Da utilizzare se per iterationType è stato specificato "Hourly".
    hours (stringa): specifica l'ora.
    minutes (stringa): specifica i minuti.
  - dailyContract (corpo): opzionale. Da utilizzare se per iterationType è stato specificato "Daily".
    runOnlyWorkWeek (booleano): opzionale. In assenza di specifica, l'impostazione predefinita è false.
  - weeklyContract (corpo): opzionale. Da utilizzare se per iterationType è stato specificato "Weekly".
    daysOfWeek (stringa): specifica il giorno della settimana in cui eseguire il flusso di lavoro. Ad esempio, "Domenica".
  - monthlyContract (corpo): opzionale. Da utilizzare se per iterationType è stato specificato "Monthly".
    simpleDayOfMonth (booleano): immetti "true" se desideri specificare un giorno del mese in cui eseguire il flusso di lavoro.
    dayOfMonth (stringa): immetti il numero del giorno del mese in cui desideri eseguire il flusso di lavoro. Ad esempio, immetti "1" per il primo giorno del mese.
    occurrence (stringa): immetti una delle seguenti opzioni se desideri eseguire il flusso di lavoro, ad esempio, la prima domenica del mese. I valori accettabili sono: "1" (prima ricorrenza), "2" (seconda ricorrenza), "3" (terza ricorrenza), "4" (quarta ricorrenza) e "-1" (ultima ricorrenza del mese).
    dayOfWeek (stringa): specifica il giorno della settimana in cui eseguire il flusso di lavoro. Ad esempio, per specificare domenica immetti "0" o "Sunday".
  - customContract (corpo): opzionale. Da utilizzare se per iterationType è stato specificato "Custom".
    daysOfMonth (array): specifica i giorni del mese in cui eseguire il flusso di lavoro. Ad esempio, [1, 15, 28].
    months (array): specifica il mese in cui eseguire il flusso di lavoro. Ad esempio, [1, 5, 7, 9, 12].
name (stringa): obbligatorio. Immetti il nome della pianificazione.
comment (stringa): obbligatorio. Immetti un commento, se necessario.
priority (stringa): opzionale. Specifica la priorità per l'esecuzione della pianificazione. Scegli tra le seguenti opzioni: "Low", "Medium", "High" e "Critical". In assenza di specifica, il valore predefinito è "Bassa".
workerTag (stringa): obbligatorio. Specifica il worker assegnato. In assenza di specifica, il valore sarà "none".
enabled (booleano): opzionale. Specifica se attivare o disattivare la pianificazione.
credentialId (stringa): obbligatorio.
timeZone (stringa): opzionale. Specifica il fuso orario in cui creare la pianificazione. Per ulteriori informazioni sui fusi orari validi, consulta la sezione Fusi orari .
Esempio: "timeZone": "Etc/GMT+4"
questions (body): Optional. For an analytic app, specify the parameters the schedule will run with.
- name (string): Enter the name of the Interface Tool used in the analytic app. For example, from the XML of the analytic app “<Question><Name>Text Box (10)</Name>”, the name is “Text Box (10)”.
- value (string): Enter the answer to the Interface Tool.

Request Example: cURL

Example of a request to update a schedule – change of the start and end time, name, and comment (body):

curl -X 'PUT' \
  'http://localhost/webapi/v3/schedules/670653d48f2f00008f001ade' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "workflowId": "6706520a102704d193b4586d",
  "ownerId": "string",
  "iteration": {
    "iterationType": "Once",
    "startTime": "2024-10-10T12:17:19.701Z",
    "endTime": "2026-10-10T12:17:19.701Z"
  },
  "name": "Once",
  "comment": "Rescheduled",
  "priority": "Low",
  "workerTag": "",
  "enabled": true,
  "credentialId": ""
}
'

Response Example

200: OK

{
  "id": "string",
  "name": "string",
  "workflowId": "string",
  "versionId": "string",
  "ownerId": "string",
  "runDateTime": "string",
  "comment": "string",
  "enabled": true,
  "priority": "Default",
  "workerTag": "string",
  "status": "string",
  "credentialId": "string",
  "creationTime": "string",
  "lastRunTime": "string",
  "state": "string",
  "runCount": 0,
  "iteration": {
    "startTime": "string",
    "endTime": "string"
  },
  "frequency": "string",
  "lastError": "string",
  "cpuName": "string",
  "lastModifiedId": "string",
  "lastModifiedDate": "string",
  "canEdit": true,
  "timeZone": "string",
  "questions": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}

400: BadRequest
401: Unauthorized
404: NotFound

Eliminazione di una programmazione

Per eliminare una pianificazione specifica dal sistema, utilizza l'endpoint DELETE {baseURL}/v3/schedules/{scheduleId}.

Nota

Users who can delete schedules with this endpoint:

Curators can delete any workflow or analytic app schedules.
Schedule owners can delete the workflow or analytic app schedules they created.
Other users within a studio can also have this permission if the studio is configured to allow them access to schedules.

Parametri

scheduleId (stringa): obbligatorio. Immetti l'ID della pianificazione da eliminare.

Request Example: cURL

curl -X 'DELETE' \
  'http://localhost/webapi/v3/schedules/670ce5fb5073000030000b8e' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'

Response Example

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

Update an Existing Schedule Using the PATCH Endpoint

To update an existing schedule without having to populate several required fields to make a single change, use the PATCH {baseURL}/v3/schedules/{scheduleId} endpoint.

Nota

Users who can update schedule with this endpoint include:
- Schedule owners.
- Curators with access to the schedule.
- Other users inside a studio if the studio is set up to allow them access the schedule.
- Users in the collection containing the schedule.
If timeZone is empty or skipped, all Date Time fields will correspond to the UTC-0 timezone. If the timeZone is specified, all the Date Time fields will correspond to the specified timezone. To view the list of valid timezones, go to Timezones.

Parameters

scheduleId (string): Required. Enter a schedule ID to get this schedule updated.
contract (body): Required. To update a schedule, the Contract parameter is required. Specify the following:
- ownerId (string): Optional. Enter a user’s ID.
- iteration (body): If you optionally submit iteration, then iterationType and startTime are required. The remaining fields are optional.
  - iterationType (string): Required if you submit iteration. Specify whether the workflow will be scheduled ‘Once’, ‘Hourly’, ‘Daily’, ‘Weekly’, ‘Monthly’, or ‘Custom’. Don’t forget to specify the hourly (hourlyContract), daily (dailyContract), weekly (weeklyContract), monthly (monthlyContract), or custom (customContract) frequency for the respective iteration type. For more information, visit the Schedule a Workflow help page.
  - startTime (string): Required if you submit iteration. Enter a specific date and time to run the workflow. The start date must be in the future.
  - endTime (string): Optional. Enter the specific date and time when the workflow run should end.
  - hourlyContract (body): Optional. Use if you specified the iterationType as 'Hourly'.
    hours (string): Optional. Enter the hour.
    minutes (string): Optional. Enter the minutes.
  - dailyContract (body): Optional. Use if you specified the iterationType as 'Daily'.
    runOnlyWorkWeek (boolean): Optional. If not specified, the default is false.
  - weeklyContract (body): Optional. Use if you specified the iterationType as 'Weekly'.
    daysOfWeek (string): Optional. Specify the day of the week when the workflow should run. For example, 'Sunday'.
  - monthlyContract (body): Optional. Use if you specified the iterationType as 'Monthly'.
    simpleDayOfMonth (boolean): Optional. Enter ‘true’ if you want to specify a specific day of the month when the workflow should run.
    dayOfMonth (string): Optional. Enter the number of the day of the month you want the workflow to run. For example, enter ‘1’ for the first day of the month.
    occurrence (string): Optional. Enter one of the following options if you want the workflow to run for example, the first Sunday of the month. The acceptable values are: '1' (first occurrence), '2' (second occurrence), '3' (third occurrence), '4' (fourth occurrence), and '-1' (the last occurrence of the month).
    dayOfWeek (integer): Optional. Specify the day of the week when the workflow should run. For example, for Sunday enter ‘0’ or ‘Sunday’.
  - customContract (body): Optional. Use if you specified the iterationType as ‘Custom’.
    daysOfMonth (array): Optional. Specify the days of the month when the workflow should run. For example, [1, 15, 28].
    months (array): Optional. Specify the month when the workflow should run. For example, [1, 5, 7, 9, 12].
name (string): Optional. Enter a name of the schedule.
comment (string): Optional. Enter a comment if needed.
priority (string): Optional. Specify the priority for running schedule. Choose from the following options: ‘Low’, ‘Medium’, ‘High’, and ‘Critical’. If not specified, the default value is ‘Low’.
workerTag (string): Optional. Specify the assigned worker. If not specified, the value will be ‘none’.
enabled (boolean): Optional. Specify whether the schedule should be enabled or disabled.
credentialId (string): Optional.
timeZone (string): Optional. Specify timezone in which the schedule should be created. For more information about valid timezones, go to Timezones.
Example: "timeZone": "Etc/GMT+4"
questions (body): Optional. For an analytic app, specify the parameters the schedule will run with.
- name (string): Optional. Enter the name of the Interface Tool used in the analytic app. For example, from the XML of the analytic app “<Question><Name>Text Box (10)</Name>”, the name is “Text Box (10)”.
- value (string): Optional. Enter the answer to the Interface Tool.

Relazioni tra oggetti

Se stai creando una pianificazione, puoi utilizzare gli oggetti creati nel modo seguente:

Oggetto creato: " scheduleId " (ad esempio, "id": "619158e57e607d0011ac3009")

Puoi utilizzarlo come:

scheduleId se cerchi una pianificazione specifica .
scheduleId se desideri aggiornare una pianificazione specifica .
scheduleId se desideri eliminare una pianificazione specifica .
scheduleId se desideri aggiungere una pianificazione specifica a una raccolta .Endpoint delle raccolte
scheduleId se desideri rimuovere una pianificazione specifica da una raccolta .Endpoint delle raccolte

Esempi di richiesta Postman

GET /v3/schedules/

Per ulteriori informazioni sulle richieste Postman, consulta la pagina di assistenza Come utilizzare Postman .

Fusi orari

In questa tabella sono indicati i fusi orari validi che puoi indicare quando utilizzi i seguenti endpoint:

POST {baseURL}/v3/schedules
PUT {baseURL}/v3/schedules
GET {baseURL}/v3/schedules/{id}
GET {baseURL}/v3/schedules

Elenco dei fusi orari

Fuso orario	Differenza rispetto a UTC
Etc/GMT+12	-12:00
Etc/GMT+11	-11:00
Pacific/Niue	-11:00
Pacific/Pago_Pago	-11:00
Etc/GMT+10	-10:00
HST	-10:00
Pacific/Honolulu	-10:00
Pacific/Rarotonga	-10:00
Pacific/Tahiti	-10:00
Pacific/Marchesi	-09:30
America/Adak	-09:00
Etc/GMT+9	-09:00
Pacific/Gambier	-09:00
America/Anchorage	-08:00
America/Juneau	-08:00
America/Metlakatla	-08:00
America/Nome	-08:00
America/Sitka	-08:00
America/Yakutat	-08:00
Etc/GMT+8	-08:00
Pacific/Pitcairn	-08:00
America/Creston	-07:00
America/Dawson	-07:00
America/Dawson_Creek	-07:00
America/Fort_Nelson	-07:00
America/Hermosillo	-07:00
America/Los_Angeles	-07:00
America/Phoenix	-07:00
America/Tijuana	-07:00
America/Vancouver	-07:00
America/Whitehorse	-07:00
Etc/GMT+7	-07:00
MST	-07:00
PST8PDT	-07:00
America/Belize	-06:00
America/Boise	-06:00
America/Cambridge_Bay	-06:00
America/Chihuahua	-06:00
America/Costa_Rica	-06:00
America/Denver	-06:00
America/Edmonton	-06:00
America/El_Salvador	-06:00
America/Guatemala	-06:00
America/Inuvik	-06:00
America/Managua	-06:00
America/Mazatlan	-06:00
America/Ojinaga	-06:00
America/Regina	-06:00
America/Swift_Current	-06:00
America/Tegucigalpa	-06:00
America/Yellowknife	-06:00
Etc/GMT+6	-06:00
MST7MDT	-06:00
Pacific/Galapagos	-06:00
America/Atikokan	-05:00
America/Bahia_Banderas	-05:00
America/Bogota	-05:00
America/Cancun	-05:00
America/Chicago	-05:00
America/Eirunepe	-05:00
America/Guayaquil	-05:00
America/Indiana/Knox	-05:00
America/Indiana/Tell_City	-05:00
America/Jamaica	-05:00
America/Lima	-05:00
America/Matamoros	-05:00
America/Menominee	-05:00
America/Merida	-05:00
America/Mexico_City	-05:00
America/Monterrey	-05:00
America/North_Dakota/Beulah	-05:00
America/North_Dakota/Center	-05:00
America/North_Dakota/New_Salem	-05:00
America/Panama	-05:00
America/Rainy_River	-05:00
America/Rankin_Inlet	-05:00
America/Resolute	-05:00
America/Rio_Branco	-05:00
America/Winnipeg	-05:00
CST6CDT	-05:00
EST	-05:00
Etc/GMT+5	-05:00
Pacific/Easter	-05:00
America/Asuncion	-04:00
America/Barbados	-04:00
America/Blanc-Sablon	-04:00
America/Boa_Vista	-04:00
America/Campo_Grande	-04:00
America/Caracas	-04:00
America/Cuiaba	-04:00
America/Curacao	-04:00
America/Detroit	-04:00
America/Grand_Turk	-04:00
America/Guyana	-04:00
America/Havana	-04:00
America/Indiana/Indianapolis	-04:00
America/Indiana/Marengo	-04:00
America/Indiana/Petersburg	-04:00
America/Indiana/Vevay	-04:00
America/Indiana/Vincennes	-04:00
America/Indiana/Winamac	-04:00
America/Iqaluit	-04:00
America/Kentucky/Louisville	-04:00
America/Kentucky/Monticello	-04:00
America/La_Paz	-04:00
America/Manaus	-04:00
America/Martinique	-04:00
America/Nassau	-04:00
America/New_York	-04:00
America/Nipigon	-04:00
America/Pangnirtung	-04:00
America/Port_of_Spain	-04:00
America/Port-au-Prince	-04:00
America/Porto_Velho	-04:00
America/Puerto_Rico	-04:00
America/Santo_Domingo	-04:00
America/Thunder_Bay	-04:00
America/Toronto	-04:00
EST5EDT	-04:00
Etc/GMT+4	-04:00
America/Araguaina	-03:00
America/Argentina/Buenos_Aires	-03:00
America/Argentina/Catamarca	-03:00
America/Argentina/Cordoba	-03:00
America/Argentina/Jujuy	-03:00
America/Argentina/La_Rioja	-03:00
America/Argentina/Mendoza	-03:00
America/Argentina/Rio_Gallegos	-03:00
America/Argentina/Salta	-03:00
America/Argentina/San_Juan	-03:00
America/Argentina/San_Luis	-03:00
America/Argentina/Tucuman	-03:00
America/Argentina/Ushuaia	-03:00
America/Bahia	-03:00
America/Belem	-03:00
America/Cayenne	-03:00
America/Fortaleza	-03:00
America/Glace_Bay	-03:00
America/Goose_Bay	-03:00
America/Halifax	-03:00
America/Maceio	-03:00
America/Moncton	-03:00
America/Montevideo	-03:00
America/Paramaribo	-03:00
America/Punta_Arenas	-03:00
America/Recife	-03:00
America/Santarem	-03:00
America/Santiago	-03:00
America/Sao_Paulo	-03:00
America/Thule	-03:00
Antarctica/Palmer	-03:00
Antarctica/Rothera	-03:00
Atlantic/Bermuda	-03:00
Atlantic/Stanley	-03:00
Etc/GMT+3	-03:00
America/St_Johns	-02:30
America/Godthab	-02:00
America/Miquelon	-02:00
America/Noronha	-02:00
Atlantic/South_Georgia	-02:00
Etc/GMT+2	-02:00
Atlantic/Cape_Verde	-01:00
Etc/GMT+1	-01:00
Africa/Abidjan	+00:00
Africa/Accra	+00:00
Africa/Bissau	+00:00
Africa/Monrovia	+00:00
Africa/Sao_Tome	+00:00
America/Danmarkshavn	+00:00
America/Scoresbysund	+00:00
Atlantic/Azores	+00:00
Atlantic/Reykjavik	+00:00
Etc/GMT	+00:00
Etc/UTC	+00:00
Africa/Algiers	+01:00
Africa/Casablanca	+01:00
Africa/El_Aaiun	+01:00
Africa/Lagos	+01:00
Africa/Ndjamena	+01:00
Africa/Tunis	+01:00
Atlantic/Canary	+01:00
Atlantic/Faroe	+01:00
Atlantic/Madeira	+01:00
Etc/GMT-1	+01:00
Europe/Dublin	+01:00
Europe/Lisbon	+01:00
Europe/London	+01:00
WET	+01:00
Africa/Cairo	+02:00
Africa/Ceuta	+02:00
Africa/Johannesburg	+02:00
Africa/Khartoum	+02:00
Africa/Maputo	+02:00
Africa/Tripoli	+02:00
Africa/Windhoek	+02:00
Antarctica/Troll	+02:00
CET	+02:00
Etc/GMT-2	+02:00
Europe/Amsterdam	+02:00
Europe/Andorra	+02:00
Europe/Belgrade	+02:00
Europe/Berlin	+02:00
Europe/Brussels	+02:00
Europe/Budapest	+02:00
Europe/Copenhagen	+02:00
Europe/Gibraltar	+02:00
Europe/Kaliningrad	+02:00
Europe/Luxembourg	+02:00
Europe/Madrid	+02:00
Europe/Malta	+02:00
Europe/Monaco	+02:00
Europe/Oslo	+02:00
Europe/Paris	+02:00
Europe/Prague	+02:00
Europe/Rome	+02:00
Europe/Stockholm	+02:00
Europe/Tirane	+02:00
Europe/Vienna	+02:00
Europe/Warsaw	+02:00
Europe/Zurich	+02:00
MET	+02:00
Africa/Juba	+03:00
Africa/Nairobi	+03:00
Antarctica/Syowa	+03:00
Asia/Amman	+03:00
Asia/Baghdad	+03:00
Asia/Beirut	+03:00
Asia/Damascus	+03:00
Asia/Famagusta	+03:00
Asia/Gaza	+03:00
Asia/Hebron	+03:00
Asia/Jerusalem	+03:00
Asia/Nicosia	+03:00
Asia/Qatar	+03:00
Asia/Riyadh	+03:00
EET	+03:00
Etc/GMT-3	+03:00
Europe/Athens	+03:00
Europe/Bucharest	+03:00
Europe/Chisinau	+03:00
Europe/Helsinki	+03:00
Europe/Istanbul	+03:00
Europe/Kiev	+03:00
Europe/Kirov	+03:00
Europe/Minsk	+03:00
Europe/Moscow	+03:00
Europe/Riga	+03:00
Europe/Simferopol	+03:00
Europe/Sofia	+03:00
Europe/Tallinn	+03:00
Europe/Uzhgorod	+03:00
Europe/Vilnius	+03:00
Europe/Zaporozhye	+03:00
Asia/Baku	+04:00
Asia/Dubai	+04:00
Asia/Tbilisi	+04:00
Asia/Yerevan	+04:00
Etc/GMT-4	+04:00
Europe/Astrakhan	+04:00
Europe/Samara	+04:00
Europe/Saratov	+04:00
Europe/Ulyanovsk	+04:00
Europe/Volgograd	+04:00
Indian/Mahe	+04:00
Indian/Mauritius	+04:00
Indian/Reunion	+04:00
Asia/Kabul	+04:30
Asia/Tehran	+04:30
Antarctica/Mawson	+05:00
Asia/Aqtau	+05:00
Asia/Aqtobe	+05:00
Asia/Ashgabat	+05:00
Asia/Atyrau	+05:00
Asia/Dushanbe	+05:00
Asia/Karachi	+05:00
Asia/Oral	+05:00
Asia/Qyzylorda	+05:00
Asia/Samarkand	+05:00
Asia/Tashkent	+05:00
Asia/Yekaterinburg	+05:00
Etc/GMT-5	+05:00
Indian/Kerguelen	+05:00
Indian/Maldives	+05:00
Asia/Colombo	+05:30
Asia/Kolkata	+05:30
Asia/Kathmandu	+05:45
Antarctica/Vostok	+06:00
Asia/Almaty	+06:00
Asia/Bishkek	+06:00
Asia/Dhaka	+06:00
Asia/Omsk	+06:00
Asia/Qostanay	+06:00
Asia/Thimphu	+06:00
Asia/Urumqi	+06:00
Etc/GMT-6	+06:00
Indian/Chagos	+06:00
Asia/Yangon	+06:30
Indian/Cocos	+06:30
Antarctica/Davis	+07:00
Asia/Bangkok	+07:00
Asia/Barnaul	+07:00
Asia/Ho_Chi_Minh	+07:00
Asia/Hovd	+07:00
Asia/Jakarta	+07:00
Asia/Krasnoyarsk	+07:00
Asia/Novokuznetsk	+07:00
Asia/Novosibirsk	+07:00
Asia/Pontianak	+07:00
Asia/Tomsk	+07:00
Etc/GMT-7	+07:00
Indian/Christmas	+07:00
Antarctica/Casey	+08:00
Asia/Brunei	+08:00
Asia/Choibalsan	+08:00
Asia/Hong_Kong	+08:00
Asia/Irkutsk	+08:00
Asia/Kuala_Lumpur	+08:00
Asia/Kuching	+08:00
Asia/Macau	+08:00
Asia/Makassar	+08:00
Asia/Manila	+08:00
Asia/Shanghai	+08:00
Asia/Singapore	+08:00
Asia/Taipei	+08:00
Asia/Ulaanbaatar	+08:00
Australia/Perth	+08:00
Etc/GMT-8	+08:00
Australia/Eucla	+08:45
Asia/Chita	+09:00
Asia/Dili	+09:00
Asia/Jayapura	+09:00
Asia/Khandyga	+09:00
Asia/Pyongyang	+09:00
Asia/Seoul	+09:00
Asia/Tokyo	+09:00
Asia/Yakutsk	+09:00
Etc/GMT-9	+09:00
Pacific/Palau	+09:00
Australia/Adelaide	+09:30
Australia/Broken_Hill	+09:30
Australia/Darwin	+09:30
Antarctica/DumontDUrville	+10:00
Asia/Ust-Nera	+10:00
Asia/Vladivostok	+10:00
Australia/Brisbane	+10:00
Australia/Currie	+10:00
Australia/Hobart	+10:00
Australia/Lindeman	+10:00
Australia/Melbourne	+10:00
Australia/Sydney	+10:00
Etc/GMT-10	+10:00
Pacific/Chuuk	+10:00
Pacific/Guam	+10:00
Pacific/Port_Moresby	+10:00
Australia/Lord_Howe	+10:30
Antarctica/Macquarie	+11:00
Asia/Magadan	+11:00
Asia/Sakhalin	+11:00
Asia/Srednekolymsk	+11:00
Etc/GMT-11	+11:00
Pacific/Bougainville	+11:00
Pacific/Efate	+11:00
Pacific/Guadalcanal	+11:00
Pacific/Kosrae	+11:00
Pacific/Norfolk	+11:00
Pacific/Noumea	+11:00
Pacific/Pohnpei	+11:00
Asia/Anadyr	+12:00
Asia/Kamchatka	+12:00
Etc/GMT-12	+12:00
Pacific/Auckland	+12:00
Pacific/Fiji	+12:00
Pacific/Funafuti	+12:00
Pacific/Kwajalein	+12:00
Pacific/Majuro	+12:00
Pacific/Nauru	+12:00
Pacific/Tarawa	+12:00
Pacific/Wake	+12:00
Pacific/Wallis	+12:00
Pacific/Chatham	+12:45
Etc/GMT-13	+13:00
Pacific/Apia	+13:00
Pacific/Enderbury	+13:00
Pacific/Fakaofo	+13:00
Pacific/Tongatapu	+13:00
Etc/GMT-14	+14:00
Pacific/Kiritimati	+14:00

In questa sezione:

Endpoint delle pianificazioni

Endpoint e parametri delle programmazioni

Creazione di una nuova pianificazione

Parametri

Request Example: cURL

Response Example

Richiesta di informazioni su tutte le pianificazioni

Parametri

Esempio di richiesta: cURL

Response Example

Ricerca di una pianificazione specifica

Parametri

Esempio di richiesta: cURL

Response Example

Aggiornamento di una pianificazione esistente

Parametri

Request Example: cURL

Response Example

Eliminazione di una programmazione

Parametri

Request Example: cURL

Response Example

Update an Existing Schedule Using the PATCH Endpoint

Parameters

Relazioni tra oggetti

Esempi di richiesta Postman

Fusi orari

Elenco dei fusi orari

Risultati della ricerca