Listes

Gérer les données de listes hiérarchiques

Lister toutes les listes (identifiants racine uniquement)

get

Retourne tous les identifiants racine des listes de l'instance, sans leurs éléments enfants.

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)

Paramètres de requête

per_pageinteger · max: 1000Optionnel

Nombre de listes par page (défaut 10, maximum 1000)

Default: 10

pageintegerOptionnel

Numéro de page (base 0)

Default: 0

updated_sinceinteger · int64Optionnel

Ne retourner que les listes modifiées après cette date (y compris supprimées)

Réponses

200

Entrées racine paginées

application/json

total_countintegerOptionnel

total_pagesintegerOptionnel

next_pageintegerOptionnel

server_timeinteger · int64Optionnel

get/{app_short}/lists

HTTPcURLJavaScriptPython

GET /{app_short}/lists HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Entrées racine paginées

{
  "lists": [
    {
      "root_id": 1,
      "name": "text",
      "created_at": 1,
      "list_last_updated": 1
    }
  ],
  "total_count": 1,
  "total_pages": 1,
  "next_page": 1,
  "server_time": 1
}

Créer une liste

post

Crée un nœud racine avec des enfants hiérarchiques optionnels via items.

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 liste

namestringRequis

Nom de la liste (obligatoire)

external_idstringOptionnel

Identifiant externe

Réponses

201

Nœud racine créé

application/json

Élément de liste

idintegerOptionnel

Identifiant de l'élément

root_idintegerOptionnel

Identifiant du nœud racine

parent_idintegerOptionnel

Identifiant du parent

created_atinteger · int64Optionnel

Date de création (timestamp UNIX)

updated_atinteger · int64Optionnel

Date de mise à jour (timestamp UNIX)

deleted_atinteger · int64 · nullableOptionnel

Date de suppression (timestamp UNIX)

namestringOptionnel

Nom affiché

has_imagebooleanOptionnel

Indique si l'élément possède une image

levelintegerOptionnel

Niveau de profondeur — 0 est le nœud racine

positionintegerOptionnel

Position à son niveau de profondeur

external_idstringOptionnel

Identifiant externe

urlstringOptionnel

URL associée à l'élément

functionnal_status_colorstringOptionnel

Couleur de l'élément (hexadécimal)

post/{app_short}/lists

HTTPcURLJavaScriptPython

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

{
  "name": "text",
  "external_id": "text",
  "items": [
    {
      "name": "text",
      "external_id": "text",
      "items": [
        {
          "name": "text",
          "external_id": "text",
          "items": [
            "[Circular Reference]"
          ]
        }
      ]
    }
  ]
}

201

Nœud racine créé

{
  "id": 1,
  "root_id": 1,
  "parent_id": 1,
  "created_at": 1,
  "updated_at": 1,
  "deleted_at": 1,
  "name": "text",
  "has_image": true,
  "level": 1,
  "position": 1,
  "external_id": "text",
  "url": "text",
  "functionnal_status_color": "text"
}

Importer une liste depuis un CSV (asynchrone)

post

Importe ou synchronise les données d'une liste depuis un fichier CSV préalablement envoyé. Interrogez le callbackUrl retourné pour suivre l'avancement.

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

list_idintegerRequis

Identifiant de la liste cible

file_idstring · uuidRequis

UUID du fichier (via l'endpoint d'envoi de fichier)

separatorstringOptionnel

Séparateur de colonnes du CSV

Default: ;

modestring · enumOptionnel

Mode d'import

Valeurs possibles:

encodingstring · enumOptionnel

Encodage du fichier

Default: UTF-8Valeurs possibles:

Réponses

200

Job asynchrone accepté

application/json

callbackUrlstringOptionnel

URL à interroger pour suivre l'avancement du job asynchrone

400

Erreur de validation (file_id manquant, encodage incorrect, fichier introuvable, etc.)

application/json

post/{app_short}/lists/import

HTTPcURLJavaScriptPython

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

{
  "list_id": 1,
  "file_id": "123e4567-e89b-12d3-a456-426614174000",
  "separator": ";",
  "mode": "APPEND",
  "encoding": "UTF-8"
}

{
  "callbackUrl": "text"
}

Récupérer les identifiants de listes et d'autorisations modifiés

post

Retourne les identifiants des listes et autorisations d'accès nécessitant une synchronisation.

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

Réponses

200

Identifiants nécessitant une mise à jour

application/json

lists_to_updateinteger[]Optionnel

lists_with_access_setinteger[]Optionnel

access_set_to_updateinteger[]Optionnel

post/{app_short}/lists/updated

HTTPcURLJavaScriptPython

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

{
  "list_states": [
    {
      "list_id": 1,
      "list_updated_since": 1,
      "access_set_updated_since": 1
    }
  ]
}

200

Identifiants nécessitant une mise à jour

{
  "lists_to_update": [
    1
  ],
  "lists_with_access_set": [
    1
  ],
  "access_set_to_update": [
    1
  ]
}

Consulter le statut d'un job asynchrone de liste

get

Retourne le statut courant d'un job d'import de liste.

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)

callback_idstring · uuidRequis

Identifiant du callback (UUID)

Réponses

200

Statut du job

application/json

get/{app_short}/lists/callback/{callback_id}

HTTPcURLJavaScriptPython

GET /{app_short}/lists/callback/{callback_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Statut du job

{
  "callbackDetails": {
    "status": "Planned",
    "nbRecordsTodo": 1,
    "nbRecordsDone": 1,
    "nbSuccess": 1,
    "nbErrors": 1,
    "success": [],
    "errors": [
      "text"
    ]
  }
}

Récupérer une liste avec tous ses éléments

get

Retourne la liste et tous ses éléments enfants avec pagination.

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)

list_idintegerRequis

Identifiant du nœud racine

Paramètres de requête

per_pageinteger · max: 1000Optionnel

Nombre d'éléments par page (maximum 1000)

pageintegerOptionnel

Numéro de la page demandée

updated_sinceinteger · int64Optionnel

Ne retourner que les éléments modifiés après cette date (y compris supprimés)

Réponses

200

Éléments de liste paginés

application/json

total_countintegerOptionnel

total_pagesintegerOptionnel

next_pageintegerOptionnel

server_timeinteger · int64Optionnel

get/{app_short}/lists/{list_id}

HTTPcURLJavaScriptPython

GET /{app_short}/lists/{list_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Éléments de liste paginés

{
  "lists": [
    {
      "id": 1,
      "root_id": 1,
      "parent_id": 1,
      "created_at": 1,
      "updated_at": 1,
      "deleted_at": 1,
      "name": "text",
      "has_image": true,
      "level": 1,
      "position": 1,
      "external_id": "text",
      "url": "text",
      "functionnal_status_color": "text"
    }
  ],
  "total_count": 1,
  "total_pages": 1,
  "next_page": 1,
  "server_time": 1
}

Supprimer une liste complète

delete

Supprime définitivement le nœud racine et tous ses enfants. La cible doit être un nœud racine.

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)

list_idintegerRequis

Identifiant du nœud racine

Réponses

204

Liste supprimée

Aucun contenu

delete/{app_short}/lists/{list_id}

HTTPcURLJavaScriptPython

DELETE /{app_short}/lists/{list_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

Liste supprimée

Aucun contenu

Modifier le nom d'éléments de liste

patch

Met à jour le name d'un ou plusieurs éléments identifiés par leur id. Envoyez un tableau d'objets {id, name}.

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)

root_idintegerRequis

Identifiant du nœud racine

Corpsobject[]

application/json

idintegerRequis

Identifiant de l'élément à modifier

namestringRequis

Nouveau nom affiché

Réponses

200

Éléments mis à jour

application/json

total_countintegerOptionnel

total_pagesintegerOptionnel

next_pageintegerOptionnel

server_timeinteger · int64Optionnel

patch/{app_short}/lists/{root_id}

HTTPcURLJavaScriptPython

PATCH /{app_short}/lists/{root_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

[
  {
    "id": 1,
    "name": "text"
  }
]

200

Éléments mis à jour

{
  "lists": [
    {
      "id": 1,
      "root_id": 1,
      "parent_id": 1,
      "created_at": 1,
      "updated_at": 1,
      "deleted_at": 1,
      "name": "text",
      "has_image": true,
      "level": 1,
      "position": 1,
      "external_id": "text",
      "url": "text",
      "functionnal_status_color": "text"
    }
  ],
  "total_count": 1,
  "total_pages": 1,
  "next_page": 1,
  "server_time": 1
}

Récupérer les identifiants sélectionnables d'une liste

get

Retourne tous les identifiants d'éléments que l'utilisateur authentifié peut sélectionner, selon les autorisations d'accès.

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)

list_idintegerRequis

Identifiant de la liste

Réponses

200

Identifiants sélectionnables

application/json

selectable_idsinteger[]Optionnel

server_timeinteger · int64Optionnel

get/{app_short}/lists/{list_id}/selectables

HTTPcURLJavaScriptPython

GET /{app_short}/lists/{list_id}/selectables HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Identifiants sélectionnables

{
  "selectable_ids": [
    1
  ],
  "server_time": 1
}

Rechercher des éléments de liste par identifiant externe

post

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)

root_idintegerRequis

Identifiant du nœud racine

Corps

application/json

external_idstringRequis

Identifiant externe recherché

Réponses

200

Éléments correspondants

application/json

Élément de liste

idintegerOptionnel

Identifiant de l'élément

root_idintegerOptionnel

Identifiant du nœud racine

parent_idintegerOptionnel

Identifiant du parent

created_atinteger · int64Optionnel

Date de création (timestamp UNIX)

updated_atinteger · int64Optionnel

Date de mise à jour (timestamp UNIX)

deleted_atinteger · int64 · nullableOptionnel

Date de suppression (timestamp UNIX)

namestringOptionnel

Nom affiché

has_imagebooleanOptionnel

Indique si l'élément possède une image

levelintegerOptionnel

Niveau de profondeur — 0 est le nœud racine

positionintegerOptionnel

Position à son niveau de profondeur

external_idstringOptionnel

Identifiant externe

urlstringOptionnel

URL associée à l'élément

functionnal_status_colorstringOptionnel

Couleur de l'élément (hexadécimal)

post/{app_short}/lists/{root_id}/search

HTTPcURLJavaScriptPython

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

{
  "external_id": "text"
}

200

Éléments correspondants

[
  {
    "id": 1,
    "root_id": 1,
    "parent_id": 1,
    "created_at": 1,
    "updated_at": 1,
    "deleted_at": 1,
    "name": "text",
    "has_image": true,
    "level": 1,
    "position": 1,
    "external_id": "text",
    "url": "text",
    "functionnal_status_color": "text"
  }
]

Récupérer les enfants directs d'un nœud

get

Retourne les enfants de premier niveau du nœud parent indiqué.

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)

root_idintegerRequis

Identifiant du nœud racine

parent_idintegerRequis

Identifiant du nœud parent

Réponses

200

Éléments enfants directs

application/json

total_countintegerOptionnel

total_pagesintegerOptionnel

next_pageintegerOptionnel

server_timeinteger · int64Optionnel

get/{app_short}/lists/{root_id}/child/{parent_id}

HTTPcURLJavaScriptPython

GET /{app_short}/lists/{root_id}/child/{parent_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Éléments enfants directs

{
  "lists": [
    {
      "id": 1,
      "root_id": 1,
      "parent_id": 1,
      "created_at": 1,
      "updated_at": 1,
      "deleted_at": 1,
      "name": "text",
      "has_image": true,
      "level": 1,
      "position": 1,
      "external_id": "text",
      "url": "text",
      "functionnal_status_color": "text"
    }
  ],
  "total_count": 1,
  "total_pages": 1,
  "next_page": 1,
  "server_time": 1
}

Mettre à jour un élément de liste

put

Met à jour les propriétés d'un élément de liste.

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)

root_idintegerRequis

Identifiant du nœud racine

list_idintegerRequis

Identifiant de l'élément de liste

Corps

application/json

Corps de mise à jour d'un élément de liste

namestringOptionnel

Nom de l'élément

latitudenumber · floatOptionnel

Latitude

longitudenumber · floatOptionnel

Longitude

external_idstringOptionnel

Identifiant externe

functionnal_status_colorstringOptionnel

Couleur de l'élément (hexadécimal)

urlstringOptionnel

URL de l'élément

Réponses

200

Élément mis à jour

application/json

itemsanyOptionnel

put/{app_short}/lists/{root_id}/{list_id}

HTTPcURLJavaScriptPython

PUT /{app_short}/lists/{root_id}/{list_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 110

{
  "name": "text",
  "latitude": 1,
  "longitude": 1,
  "external_id": "text",
  "functionnal_status_color": "text",
  "url": "text"
}

200

Élément mis à jour

[]

Supprimer un élément de liste

delete

Supprime l'élément et tous ses enfants de manière récursive.

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)

root_idintegerRequis

Identifiant du nœud racine

list_idintegerRequis

Identifiant de l'élément de liste

Réponses

204

Élément supprimé

Aucun contenu

delete/{app_short}/lists/{root_id}/{list_id}

HTTPcURLJavaScriptPython

DELETE /{app_short}/lists/{root_id}/{list_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

Élément supprimé

Aucun contenu

Ajouter des enfants en masse à un nœud

patch

Ajoute plusieurs éléments enfants à un nœud parent en une seule requête.

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)

root_idintegerRequis

Identifiant du nœud racine

list_idintegerRequis

Identifiant du nœud parent

Corpsobject · ListItemUpdateRequest[]

application/json

Corps de mise à jour d'un élément de liste

namestringOptionnel

Nom de l'élément

latitudenumber · floatOptionnel

Latitude

longitudenumber · floatOptionnel

Longitude

external_idstringOptionnel

Identifiant externe

functionnal_status_colorstringOptionnel

Couleur de l'élément (hexadécimal)

urlstringOptionnel

URL de l'élément

Réponses

200

Enfants ajoutés

application/json

itemsanyOptionnel

patch/{app_short}/lists/{root_id}/{list_id}

HTTPcURLJavaScriptPython

PATCH /{app_short}/lists/{root_id}/{list_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 112

[
  {
    "name": "text",
    "latitude": 1,
    "longitude": 1,
    "external_id": "text",
    "functionnal_status_color": "text",
    "url": "text"
  }
]

200

Enfants ajoutés

[]

Récupérer l'image d'un élément de liste

get

Retourne l'image de l'élément — uniquement si has_image est true.

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)

root_idintegerRequis

Identifiant du nœud racine

list_idintegerRequis

Identifiant de l'élément de liste

Réponses

200

Contenu de l'image

image/jpeg

string · binaryOptionnel

get/{app_short}/lists/{root_id}/{list_id}/image

HTTPcURLJavaScriptPython

GET /{app_short}/lists/{root_id}/{list_id}/image HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Contenu de l'image

binary

Changer la position d'un nœud

put

Déplace un nœud par rapport à un nœud de référence.

direction	Effet
child	Devient le premier enfant du nœud de référence
before	Positionné juste avant le nœud de référence (même parent)
after	Positionné juste après le nœud de référence (même parent)

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)

root_idintegerRequis

Identifiant racine de la liste à modifier

node_to_move_idintegerRequis

Identifiant du nœud à déplacer

directionstring · enumRequis

Direction de placement par rapport au nœud de référence

Valeurs possibles:

node_position_idintegerRequis

Identifiant du nœud de référence

Réponses

200

Nœud repositionné

Aucun contenu

put/{app_short}/lists/{root_id}/{node_to_move_id}/{direction}/{node_position_id}

HTTPcURLJavaScriptPython

PUT /{app_short}/lists/{root_id}/{node_to_move_id}/{direction}/{node_position_id} HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Nœud repositionné

Aucun contenu