Création de tâches

Créer des tâches simples ou récurrentes

Créer une tâche (simple ou récurrente)

post

Crée une tâche liée à un modèle de fiche (submission_model_id) ou à une liste de fiches (submissions). Pour une tâche récurrente, ajoutez l'objet recurrency ; dans ce cas due_date n'est pas obligatoire.

Autorisations

BearerAuth

AuthorizationstringRequis

Bearer authentication header of the form Bearer <token>.

Paramètres de chemin

app_shortstringRequis

Nom court de l'instance (ex. daxium-test)

Corps

application/json

Corps de création d'une tâche. Fournissez soit submission_model_id, soit submissions. Ajoutez recurrency pour une tâche récurrente (dans ce cas due_date est optionnel).

start_dateinteger · int64Requis

Date de début de la tâche (timestamp UNIX)

due_dateinteger · int64Optionnel

Date d'échéance (timestamp UNIX). Optionnel pour une tâche récurrente.

submission_model_idstring · uuidOptionnel

Identifiant d'un modèle de fiche

submissionsstring · uuid[]Optionnel

Liste d'identifiants de fiches

user_idinteger · nullableOptionnel

Identifiant de l'utilisateur assigné

durationintegerOptionnel

Durée de la tâche en secondes

delay_beforeintegerOptionnel

Délai d'affichage indicatif en secondes avant le début de la tâche

delay_afterintegerOptionnel

Délai d'affichage indicatif en secondes après l'échéance de la tâche

Réponses

200

Tâche créée

application/json

Tâche liée à une fiche

idstring · uuidOptionnel

Identifiant de la tâche

created_atinteger · int64Optionnel

Date de création (timestamp UNIX)

updated_atinteger · int64Optionnel

Date de mise à jour (timestamp UNIX)

start_dateinteger · int64Optionnel

Date de début prévue (timestamp UNIX)

due_dateinteger · int64Optionnel

Date d'échéance (timestamp UNIX)

durationintegerOptionnel

Durée prévue en secondes

delay_beforeintegerOptionnel

Délai d'affichage indicatif en secondes avant le début de la tâche

delay_afterintegerOptionnel

Délai d'affichage indicatif en secondes après la fin de la tâche

user_idintegerOptionnel

Identifiant de l'utilisateur assigné

post/{app_short}/tasks

HTTPcURLJavaScriptPython

POST /{app_short}/tasks HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 344

{
  "start_date": 1,
  "due_date": 1,
  "submission_model_id": "123e4567-e89b-12d3-a456-426614174000",
  "submissions": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "user_id": 1,
  "duration": 1,
  "delay_before": 1,
  "delay_after": 1,
  "recurrency": {
    "type": "daily",
    "interval": 1,
    "days": {
      "ANY_ADDITIONAL_PROPERTY": {
        "start": "text",
        "end": 1
      }
    },
    "end": {
      "type": "occurrence",
      "value": 1
    }
  }
}

200

Tâche créée

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": 1,
  "updated_at": 1,
  "start_date": 1,
  "due_date": 1,
  "duration": 1,
  "delay_before": 1,
  "delay_after": 1,
  "user_id": 1,
  "submission": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "structure_id": 1,
    "structure_version": 1,
    "created_at": 1,
    "updated_at": 1,
    "data_created_at": 1,
    "data_updated_at": 1,
    "user_id": 1,
    "channels": [
      "text"
    ],
    "items": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "submission_number": 1,
    "number_in_structure": 1,
    "latitude": 1,
    "longitude": 1,
    "last_updated_user_id": 1,
    "current_state": "123e4567-e89b-12d3-a456-426614174000",
    "assigned_user": {
      "id": 1,
      "email": "[e-mail]",
      "first_name": "text",
      "last_name": "text",
      "groups": [],
      "system_groups": []
    },
    "subscribers": [],
    "settings": []
  }
}