API

Descubre cómo puedes aprovechar Kanbanize Restful API.

Información general


Para usar Kanbanize API, debes enviar una solicitud de https POST a la siguiente dirección:

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/<función>

 

Donde:

<subdomain> es la parte del subdominio para tu cuenta.

<función> es uno de los siguientes:

 

Se implementan los siguientes límites para usar la API:

Función login get_projects_and_boards get_board_structure get_board_settings create_new_task delete_task get_task_details
Límite por hora (por CLAVE API) 30 30 30 30 30 60 60
Función get_all_tasks add_comment move_task edit_task get_board_activities block_task  
Límite por hora (por CLAVE API) 60 30 60 30 30 30  

Autenticación


Cada usuario de Kanbanize tiene una clave API personal que se utiliza para autenticar al usuario cuando accede a la API. Cada solicitud de API (excepto las de la función de “inicio de sesión”) debe contener un encabezado http válido denominado “apikey”. El valor del encabezado debe ser una clave API válida. Puedes obtenerla desde la salida de la función “iniciar sesión” o a través de la versión web (haz clic en tu nombre de usuario en la esquina superior derecha y selecciona API).

Si tienes habilitada la Autenticación de Dos Factores (2FA) para tu cuenta, debes proporcionar un encabezado http adicional llamado “otp”. Este encabezado debe contener una contraseña única válida (OTP) para el momento en que se realiza la solicitud. El algoritmo para generar una contraseña única se basa en la implementación de implementación de Google Authenticator. Debes almacenarla en un lugar seguro y usarla para generar OTP cuando sea necesario. Para obtener más información sobre cómo usar 2FA con Kanbanize, consulta esta publicación en nuestro blog.

 

 

Parámetros de entrada


Dependiendo de la función a la que estás accediendo, debes especificar ciertos parámetros para que la solicitud se pueda procesar correctamente. La forma en que se configuran los parámetros es insertándolos en la solicitud URI o en el cuerpo de la solicitud. El cuerpo de la solicitud es el enfoque recomendado.

 

Ejemplos:

 

Enviar un parámetro “boardid” con el valor 22 como parte de la solicitud URI:

 

https://<subdomain>/index.php/api/kanbanize/<function>/boardid/22

 

Enviar un parámetro “boardid” con el valor 22 y el parámetro “taskid” con el valor 14 como parte de la solicitud URI:

 

https://<subdomain>/index.php/api/kanbanize/<function>/boardid/22/taskid/14

 

Enviar un parámetro “boardid” con el valor 22 y el parámetro “taskid” con el valor 14 como parte de la solicitud CUERPO. El CUERPO necesita ser una cadena JSON válida. Si se establece un valor tanto en el CUERPO como en el URI, se toma el valor CUERPO. Si usa la barra diagonal inversa (\) o una comilla doble (“), debe escapar de ellos con el carácter de barra diagonal inversa: (\\) o (\”).

 

Solicitud URI: https://<subdomain>/index.php/api/kanbanize/<function>

Cuerpo de la solicitud: {"boardid":22,"taskid":14}

 

También puedes especificar el formato del resultado. Los formatos disponibles son:

 

XML (predeterminado si no se proporciona el parámetro de formato)

 

https://<subdomain>/index.php/api/kanbanize/<function>/<parameters>/format/xml

 

JSON (para más información, consulta este sitio web http://www.json.org/)

 

https://<subdomain>/index.php/api/kanbanize/<function>/<parameters>/format/json

Iniciar Sesión [login]


Necesario  email pass
  Tu correo electrónico Tu contraseña
Opcional n/a
   
Salida mail username realname companyname timezone apikey
  Tu correo electrónico Tu nombre de usuario Tu nombre Nombre de empresa Tu zone horaria Tu clave API.

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/login/
Cuerpo de la solicitud: {"email": "test@test.com", "pass":"test"}

 

Proyectos y tableros [get_projects_and_boards]


Necesario  n/a
   
Opcional n/a
   
Salida projects projects[][name] projects[][id] projects[][boards]
  Matriz de los proyectos. El nombre del proyecto La ID del proyecto Matriz de detalles para cualquier tablero en el proyecto actual (nombre, id)

 

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_projects_and_boards/

Esctructura del tablero [get_board_structure]


Necesario  boardid
  La ID del tablero cuya estructura desea obtener. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero.
Opcional n/a
   
Salida columns columns[][position] columns[][lcname] columns[][description] lanes lanes[][lcname] lanes[][color] lanes[][description]
  Matriz que contiene las columnas del tablero (solo se devuelven las columnas en el último nivel) La posición de la columna El nombre de la columna. La descripción de la columna o calle. Matriz que contiene las calles del tablero. El nombre de la calle. El color de la calle. La descripción de la columna o calle.

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_board_structure/
Cuerpo de la solicitud: {"boardid":"2"}

Estructura completa del tablero [get_full_board_structure]


Necesario  boardid
  La ID del tablero cuya estructura desea obtener. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero.
Opcional n/a
   
Salida columns columns[][position] columns[][lcname] columns[][path] columns[][description] columns[][lcid] columns[][children[]]* lanes lanes[][position] lanes[][lcname] lanes[][path] lanes[][color] lanes[][description] lanes[][lcid]
  Matriz que contiene las columnas del tablero La posición de la columna El nombre de la columna Identificador único que contiene la identificación de la columna con todas sus columnas principales. P.ej. progress_17_1478 significa que la ID de la columna es 1478, su elemento primario es la columna con id 17 y el área principal está EN PROGRESO. La descripción de la columna o calle ID de Calle / Columna. Esta es la ID de la columna, que es la última parte del parámetro de ruta descrito anteriormente. Si la columna tiene subcolumnas, se devuelven en la matriz de elementos secundarios recursivamente. Matriz que contiene las calles del tablero La posición de la calle El nombre de la calle Identificador único de la calle que concatena la cadena “lane_” concatenada con la ID de la calle. El color de la calle. La descripción de la columna o calle. ID de Calle / Columna. Esta es la ID de la columna, que es la última parte del parámetro de ruta descrito anteriormente.

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_full_board_structure/
Cuerpo de la solicitud: {"boardid":"2"}

Ajustes de tablero [get_board_settings]


Necesario  boardid
  La ID del tablero cuya estructura desea obtener. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero.
Opcional n/a
   

Matriz con las definiciones de todos los campos personalizados asignados al tablero. 

Salida usernames avatars templates types customFields
  Matriz que contiene los nombres de usuario de los miembros del tablero. Matriz asociativa que contiene las URL de los avatares de los miembros del tablero. Matriz que contiene las plantillas disponibles para este tablero. Matriz que contiene los tipos disponibles para este tablero. Matriz que contiene las definiciones de todos los campos personalizados asignados al tablero.

 

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_board_settings/
Cuerpo de la solicitud: {"boardid":"2"}

Obtener actividades de tablero [get_board_activities]


Necesario  boardid fromdate todate
  La ID del tablero. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero. La fecha después de la cual ocurrieron las actividades de interés. Acepta los siguientes formatos: ‘2012-05-05′, ’10 de Septiembre 2012’ La fecha antes de la cual ocurrieron las actividades de interés. Acepta los siguientes formatos: ‘2012-05-05′, ’10 Septiembre de 2012’.
Opcional page resultsperpage author eventtype textformat
  El valor predeterminado es 1 El valor predeterminado es 30 El valor predeterminado es TODO Opciones: Transiciones, Actualizaciones, Comentarios, Bloqueos. El valor predeterminado es TODO Opciones: “simple” (predeterminado) y “html”. Si se utiliza el formato de texto simple, las etiquetas HTML se eliminan de los detalles del historial.
Salida allactivities page activities activities[][author] activities[][event] activities[][text] activities[][date] activities[][taskid]
  El número de todas las actividades para el intervalo de tiempo correspondiente especificado por los parámetros fromdate y todate. La página actual. Matriz que contiene las actividades del tablero. Quién realizó la acción. Tipo de evento (Tarea movida, Tarea bloqueada, Tarea archivada, etc.) Detalles del historial. Cuándo ocurrió el evento. La id de la tarea que se actualizó / movió / bloqueó, etc.

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_board_activities/
Cuerpo de la solicitud: {"boardid":"2", "fromdate":"2012-08-05", "todate":"2017-08-05", "page":"2"}

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_board_activities/
Cuerpo de la solicitud: {"boardid":"2", "fromdate":"2012-08-05", "todate":"2017-08-05", "page":"3", "eventtype":"Comments"}

Crear nueva tarea [create_new_task]


Si el usuario identificado por la clave API tiene preconfigurada la columna o calle predeterminada para el tablero especificado, y no se proporciona ningún parámetro de “columna” o “calle” en la solicitud, la tarea se creará en la columna y calle especificadas en la configuración predeterminada del tablero.

 

Si no se configura ninguna columna o calle predeterminada para el tablero especificado y no se proporcionan parámetros de “columna” o “calle” en la solicitud, la tarea se creará en la primera calle de la sección Backlog del tablero.

 

Si se proporcionan los parámetros ‘columna’, ‘calle’ y / o ‘posición’, entonces una operación de movimiento se ejecuta automaticamente después de la creación de la tarea. Los parámetros ‘columna’ y ‘calle’ anulan de manera efectiva cualquier configuración con respecto a dónde se creará la tarea.

 

 

Necesario  boardid
  La ID del tablero cuya estructura desea obtener. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero.
Opcional title description priority assignee color size tags deadline extlink type template < customfield > subtasks subtasks[][title] subtasks[][assignee] column lane position exceedingreason returntaskdetails
  Título de la tarea Descripción de la tarea Una de las siguientes: Baja, Media, Alta Nombre de usuario del asignado (debe ser un nombre de usuario válido) Cualquier código de color (por ejemplo, # 34a97b) sin el carácter #. Tamaño de la tarea Lista de etiquetas separadas por espacios Fecha límite en el formato: aaaa-mm-dd (por ejemplo, 2011-12-13) Un enlace en el siguiente formato: https://domain.com/resource. Esta opción solo se admite cuando los parámetros se envían en el cuerpo de la solicitud. El nombre del tipo que deseas establecer. El nombre de la plantilla que deseas aplicar. Si especifica alguna propiedad como parte de la solicitud, se sobrescribirá la especificada en la plantilla. El nombre del campo personalizado que deseas establecer. Una matriz de subtareas. Título de la nueva subtarea. Un asignado para la subtarea (Valor predeterminado: Ninguno). El nombre de la columna para crear la tarea (por defecto es Backlog). Si los nombres de columna no son únicos, debe especificar la ruta completa a la columna: topParentColumn.nextParentColumn.columnName. El nombre de la calle para poner la tarea recién creada. Si se omite, la tarea se colocará en la primera calle. La posición de la tarea en la nueva columna / calle (basada en cero). Si se omite, la tarea se colocará en la parte inferior de la columna. Si puedes superar un límite por un motivo, proporcionalo con este parámetro. Aplicable solo si se suministra columna, calle y / o posición. Si se establece en 1, el método devolverá los detalles de la tarea creada.
Salida id details movingerror
  La ID de la tarea recién creada. Los detalles de la tarea recién creada. (Solo si returntask se ha configurado)
El formato es el mismo que el resultado de get_task_details.
Si el movimiento falla, el error de movimiento se devolverá aquí. (Solo si se establecieron columna, calle y / o posición)

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/create_new_task/
Cuerpo de la solicitud: {"boardid":"17", "title":"test task", "description":"task description", "priority":"High", "assignee":"mitaka", "color":"FFCC00", "tags":"tag1 tag2", "deadline":"2011-12-13"}

Eliminar tarea [delete_task]


Necesario  boardid taskid
  La ID del tablero donde se encuentra la tarea que se eliminará. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de tablero. La ID de la tarea a eliminar.
Opcional n/a
   
Salida status
  El estado de la operación (1 o error).

 

http://<subdomain>.kanbanize.com/index.php/api/kanbanize/delete_task/
Cuerpo de la solicitud: {"boardid":"17", "taskid":"173"}

Obtener detalles de tarea [get_task_details]


 

Necesario  boardid taskid/taskid[]
  La ID del tablero donde se encuentra la tarea. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero. La ID de la tarea (o una matriz de ids de tareas) cuyos detalles deseas obtener.
Opcional history comments event textformat
  Selecciona “sí” si deseas obtener el historial de la tarea. Selecciona “sí” si deseas obtener comentarios para la tarea. Solo aplicable si “historial” está establecido como “sí”. Acepta los siguientes eventos: mover, crear, actualizar, bloquear, eliminar, comentar, archivar, subtarea, tiempo registrado. Si el parámetro no está establecido, se devolverán todos los eventos. Opciones: “simple” (predeterminado) y “html”. Si se utiliza el formato de texto simple, las etiquetas HTML se eliminan de la descripción de la tarea.
Salida taskid title description type assignee subtasks subtaskscomplete color priority size deadline deadlineoriginalformat extlink tags leadtime blocked blockedreason subtaskdetails comments historydetails columnname lanename columnid laneid position columnpath loggedtime customfields customfields[][fieldid] customfields[][name] customfields[][type] customfields[][value] customfields[][mandatory] attachments attachments[][url] attachments[][clientName] attachments[][uniqueName] attachments[][fileSize] attachments[][fileType] attachments[][status] workflow
  La ID de la tarea Título de la tarea Descripción de la tarea El tipo de la tarea Nombre de usuario del asignado Número de subtareas Número de subtareas completadas Color de tarea Prioridad de tarea Tamaño de tarea Fecha límite de la tarea en formato Día Mes (por ejemplo, 01 Ago) Fecha límite de la tarea en formato yyyy-mm-dd (por ejemplo, 2012-08-01) Enlace externo de tarea Etiquetas de tarea Plazo de entrega en días Está bloqueada la tarea (0 – no / 1 – sí) Por qué la tarea está bloqueada Detalles de cualquier subtarea (id de subtarea, asignado de subtarea, título de subtarea, fecha de compleción de subtarea). Detalles de cualquier comentario (autor, evento, texto, fecha, taskid, id). Detalles del historial de tareas (tipo de evento, historial, detalles, autor, fecha, id del historial). El nombre de la columna en la que se encuentra la tarea. El nombre de la calle en la que se encuentra la tarea. La ID de la columna en la que se encuentra la tarea. La ID de la calle en la que se encuentra la tarea. La posición de la tarjeta en su columna actual. La ruta completa a la columna de la tarjeta en el formato: “Column.Subcolumn1.Subcolumn2”. Si la tarea está ubicada en una columna principal, será igual que “columnname”. El tiempo registrado acumulado de la tarea en horas. Matriz de los campos personalizados aplicados a la tarjeta. El número ID del campo. El nombre del campo. Tipo de datos del campo personalizado {texto | fecha | número | colaborador | enlace | menú desplegable}. El valor del campo personalizado. Una bandera si el campo es obligatorio {verdadero | falso}. Matriz con la información sobre los nuevos archivos adjuntos a la tarjeta. Un enlace al archivo si se ha agregado desde un servicio de almacenamiento (Dropbox, Google Drive, etc.). El nombre del archivo subido por el usuario. Nombre único del archivo. El tamaño del archivo. La extensión del archivo. Estado de carga. El flujo de trabajo al que pertenece el asunto (0-flujo de trabajo de tarjetas / 1-flujo de trabajo de iniciativas).
 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_task_details/
Cuerpo de la solicitud: {"boardid":"17", "taskid":"173"}

Obtener todas las tareas [get_all_tasks]


 

Necesario  boardid
  La ID del tablero donde se encuentran las tareas. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero.
Opcional subtasks comments container fromdate todate showInitiatives version page textformat column lane section
  Selecciona “sí” si deseas obtener detalles de la subtarea para cada tarea. Selecciona “sí” si deseas obtener comentarios para cada tarea. Selecciona “archivar” si deseas obtener tareas del archivo. Vea el resto de los parámetros opcionales para detalles de salida del archivo. Solo aplicable con contenedor= “archivo”. La fecha después de la cual las tareas han sido archivadas. Acepta el formato: ‘2012-05-05’. Valor predeterminado es ‘1970-01-01’ Solo aplicable con contenedor= “archivo”. La fecha antes de la cual las tareas han sido archivadas. Acepta el siguiente formato: ‘2012-05-05’. Valor predeterminado es ‘ahora’ Solo aplicable con contenedor = “archivo”. Si este parámetro se establece en “1”, la respuesta devolverá solo iniciativas. De lo contrario, devolverá solo tareas. Da las tareas desde la versión de archivo especificada. Los parámetros fromdate y todate se ignoran. Solo aplicable con contenedor = “archivo”. Con este parámetro, controlas qué número de página obtener. El método devuelve 30 tareas por página. Si no están configurados, se devolverán los primeros 30 valores, es decir, “page” = 1. Opciones: “simple” (predeterminado) y “html”. Si se utiliza el formato de texto simple, las etiquetas HTML se eliminan de la descripción de la tarea. Obtén solo tarjetas de una columna específica. Este campo tiene mayor prioridad que la opción de sección. Si el nombre de la columna es único, puedes especificarlo solo, pero si hay más de una columna con ese nombre, debes especificarlo como Columna Principal. Nombre de Columna  Solo obtén tarjetas de ese carril específico. Obtén la tarjeta de un área específica del tablero (backlog, solicitado, en curso, hecho, archivado)
Salida taskid position type assignee title description subtasks subtaskscomplete color priority size deadline deadlineoriginalformat extlink tags columnid laneid workflow leadtime blocked blockedreason subtaskdetails comments columnname lanename columnpath logedtime* attachments attachments[][url] attachments[][clientName] attachments[][uniqueName] attachments[][fileSize] attachments[][fileType] attachments[][status]
  La ID de la tarea La posición de la tarea El tipo de tarea Nombre de usuario del asignado Título de la tarea Descripción de la tarea Número de subtareas Número de terminado subtareas Color de tarea Prioridad de tarea Tamaño de tarea Fecha límite de la tarea en formato Día Mes (por ejemplo, 01 Ago) Fecha límite de la tarea en formato aaaa-mm-dd (por ejemplo, 2012-08-01) Enlace externo de tarea Etiquetas de tarea La ID de la columna en la que se encuentra la tarea. La ID de la calle en la que se encuentra la tarea. El flujo de trabajo al que pertenece el Ítem (0 – flujo de trabajo de tarjetas / 1 – flujo de trabajo de iniciativas) Plazo de entrega en días Está bloqueada la tarea (0 – no / 1 – sí) Por qué está bloqueada la tarea Detalles de cualquier subtarea (id de subtarea, asignado de subtarea, título de subtarea, fecha de compleción de subtarea). Detalles de cualquier comentario (autor, evento, texto, fecha, taskid). El nombre de la columna en la que se encuentra la tarea. El nombre de la calle en la que se encuentra la tarea. La ruta completa a la columna de la tarjeta en el formato: “Column.Subcolumn1.Subcolumn2”. Si la tarea está ubicada en una columna principal, será igual que “columnname”. El tiempo registrado acumulado de la tarea en horas. * Falta una letra G, que no ha sido agregada a propósito para mantener la compatibilidad con versiones anteriores. Matriz con la información sobre los nuevos archivos adjuntos a la tarjeta. Un enlace al archivo si se ha agregado desde un servicio de almacenamiento (Dropbox, Google Drive, etc.). El nombre del archivo cargado por el usuario. Nombre único del archivo. Tamaño del archivo. Extensión del archivo. Estado de carga.
 
 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_all_tasks/
Cuerpo de la solicitud: {"boardid":"17"}

Añadir comentario [add_comment]


Necesario comment taskid
  El comentario que será añadido. La ID de la tarea que desea comentar.
Opcional n/a
   
Salida id author date
  ID del evento de historia Autor del comentario Fecha actual
 
 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/add_comment/
Cuerpo de la solicitud: {"taskid":"173", "comment":"this is a test comment"}

Mover tarea [move_task]


Con esta acción puede mover tareas en el tablero especificando el nombre de la columna y, opcionalmente, el nombre de la calle.

 

Necesario  boardid taskid
  La ID del tablero para mover la tarea en éste. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero. La ID de la tarea a mover
Opcional column lane position* exceedingreason
  El nombre de la columna para mover la tarea en ésta. Si el nombre de la columna es único, puede especificarlo solo, pero si hay más de una columna con ese nombre, debe especificarlo como columnname1. columnname2. columnname3. El nombre de la calle para mover la tarea en ésta. Si se omite, la calle no cambia. La posición de la tarea en la nueva columna (basada en cero). Si se omite, la tarea se colocará en la parte inferior de la columna.
*Este parámetro no se tiene en cuenta al mover tareas a otro tablero.
Si puedes superar un límite por un motivo, proporcionalo con este parámetro.
Salida status
  El estado de la operación (1 o error).
https://<subdomain>.kanbanize.com/index.php/api/kanbanize/move_task/
Cuerpo de la solicitud: {"boardid":"17", "taskid":"24", "column":"MyColumn"}
 
https://<subdomain>.kanbanize.com/index.php/api/kanbanize/move_task/
Cuerpo de la solicitud: {"boardid":"17", "taskid":"24", "column":"MainColumn.SubColumn.MyColumn"}
 
https://<subdomain>.kanbanize.com/index.php/api/kanbanize/move_task/
Cuerpo de la solicitud: {"boardid":"17", "taskid":"24", "column":"MainColumn.SubColumn.MyColumn", "lane":"Bugs"}

Editar tarea [edit_task]


With this action you can update the task details.

 

Necesario boardid taskid
  La ID del tablero donde se encuentra la tarea que se va a editar. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero. La ID de la tarea que se va a editar.
Opcional title description priority assignee color size tags deadline extlink type < customfield >
  Título de la tarea Descripción de la tarea Una de las siguientes: Baja, Media, Alta, Crítica Nombre de usuario del asignado (debe ser un nombre de usuario válido) Cualquier código de color (por ejemplo, # 34a97b) sin el carácter # delante del código. Tamaño de la tarea Lista de etiquetas separadas por espacios Fecha límite en el formato: aaaa-mm-dd (por ejemplo, 2011-12-13) Un enlace en el siguiente formato: https://domain.com/resource. Esta opción solo se admite cuando los parámetros se envían en el cuerpo de la solicitud. El nombre del tipo que deseas establecer. Un campo personalizado para ser actualizado. Si el campo no está presente en la tarjeta, se asignará automaticamente con el valor proporcionado.
Salida status
  El estado de la operación (1 o error).
 
 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/edit_task/
Cuerpo de la solicitud: {"boardid":"17", "taskid":"24", "title":"My new title", "description":"My new description", "size":"24"}

Bloquear tarea [block_task]


Necesario boardid taskid event blockreason
  La ID del tablero donde se encuentra la tarea que se va a bloquear / desbloquear. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero. La ID de la tarea Posibles valores: ‘block’ – bloquea una tarea; ‘editblock’ – edita el motivo bloqueado; ‘unblock’ – desbloquea una tarea Necesario si el evento está configurado como ‘block’ o ‘editblock’
Opcional n/a
   
Salida status
  El estado de la operación (1 o error).
 
 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/block_task/
Cuerpo de la solicitud: {"boardid":"2", "taskid":"1173", "event":"block", "blockreason":"Reason text"}


https://<subdomain>.kanbanize.com/index.php/api/kanbanize/block_task/
Cuerpo de la solicitud: {"boardid":"2", "taskid":"1173", "event":"unblock"}

Añadir subtarea [add_subtask]


Necesario taskparent
  La ID de la tarea donde se encuentra la subtarea que se creará.
Opcional title assignee
   Título de la subtarea Nombre de usuario del asignado (debe ser un nombre de usuario válido)
Salida status
  La ID de la subtarea recién creada o 0 si se ha producido un error.
 
 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/add_subtask/
Cuerpo de la solicitud: {"taskparent":"254", "title":"sample subtask title", "assignee":"myusername"}

Editar subtarea [edit_subtask]


Necesario boardid subtaskid
  La ID del tablero donde se encuentra la subtarea que se va a editar. Puedes ver la ID del tablero en la pantalla de tableros, en la esquina superior derecha de cada tablero. La ID de la subtarea
Opcional title assignee complete
   Título de la subtarea Nombre de usuario del asignado (debe ser un nombre de usuario válido) Opciones: 1 o 0. Si está configurado en 1, la subtarea estará marcada como finalizada, de lo contrario como inacabada.
Salida status
  El estado de la operación (1 o error).
 
 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/edit_subtask/
Cuerpo de la solicitud: {"boardid":"68", "subtaskid":"673", "title":"new subtask title", "complete":"1"}

Tiempo de registro [log_time]


Necesario loggedtime taskid
  La cantidad de horas que deseas agregar a la tarea. La ID de la tarea o subtarea en la que registrar el tiempo.
Opcional description date
  Comentario sobre la entrada de registro de tiempo. Establece la fecha para la cual se registra el tiempo. El formato aceptado es AAAA-MM-DD.
Salida id historyid taskid author details loggedtime issubtask title comment origindate entrydate
  La ID del evento de tiempo de registro. La id del evento (para uso interno). La id de la tarea o subtarea que se ha actualizado con un evento de tiempo de registro. El nombre de usuario del usuario API que actualizó la tarea. Mensaje explicando el evento de tiempo de registro. La cantidad de horas que se han registrado. Un parámetro booleano que muestra si la tarea es una subtarea o no. El título de la tarea que se ha actualizado. El comentario que se ha agregado junto con el registro de tiempo. Sello de tiempo del evento (sin zona horaria aplicada). Sello de tiempo del evento (zona horaria aplicada).
 
 
 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/log_time/
Cuerpo de la solicitud: {"taskid":"68", "loggedtime":"673"}

Obtener enlaces [get_links]


La llamada a este método devolverá una matriz que contiene los datos de enlaces. Las tareas que no tienen ningún enlace serán omitidas.

Necesario boardid or taskid
 

boardid: Un entero o una matriz de enteros. Se devolverán los datos de los enlaces de todas las tareas; taskid: un entero o una matriz de enteros para los que se devolverán los datos de los enlaces.

Opcional boardid taskid
  Un entero simple o una matriz de enteros que denotan IDs de tableros. Se devolverán los datos de los enlaces de todas las tareas en los tableros. Un entero único o una matriz de enteros que denota las ID de tareas para las cuales se devolverán los datos de los enlaces.
Salida taskid parent children mirrors relatives predecessors successors
  La ID de la tarea a la que pertenecen los datos de los enlaces. La ID de tarea asignada como padre. Una matriz de ID de tareas, que son elementos secundarios de la tarea. Una matriz de ID de tareas, que son espejos de la tarea. Una matriz de ID de tareas, que son relativos de la tarea. Una matriz de ID de tareas, que son predecesores de la tarea. Una matriz de ID de tareas, que son sucesores de la tarea.

http://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_links/
Cuerpo de la solicitud: {"taskid":[17,27], "boardid":"4"}

Editar enlace [edit_link]


Necesario taskid action type linkedid
  La ID de la tarea que se vinculará. Opciones: “set” o “unset” Opciones: ‘niño’, ‘padre’, ‘relativo’, ‘espejo’, ‘predecesor’, ‘sucesor’. Para todos los tipos de enlaces, la lógica es la siguiente: Make {taskid} a {type} of {linkedid} La ID de la tarea que se vinculará con {taskid}.
Opcional n/a
   
Salida status
  El estado de la operación (1 o error).

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/edit_link/
Cuerpo de la solicitud: {"taskid":"17", "action":"set", "linkedid":"27", "type":"relative"}

Añadir adjunto [add_attachment]


Esta función es diferente de las demás. La solicitud debe codificarse como multipart / form-data. Una parte debe llamarse params y debe contener un JSON con el boardid y taskid de la tarea a la que desea agregar un archivo adjunto. Las otras partes (entre 1 y 5) deben contener los archivos que se adjuntarán en formato binario.

Output attachments attachments[][url] attachments[][clientName] attachments[][uniqueName] attachments[][fileSize] attachments[][fileType] attachments[][status]
  Matriz con la información sobre los nuevos archivos adjuntos a la tarjeta. Un enlace al archivo si se ha agregado desde un servicio de almacenamiento (Dropbox, Google Drive, etc.). El nombre del archivo subido por el usuario. Nombre único del archivo. Tamaño del archivo. Extensión del archivo. Estado de carga.
 
 
https://<subdomain>.kanbanize.com/index.php/api/kanbanize/add_attachment/

Encabezados de la solicitud:
content-type: multipart/form-data; boundary=AnyStringNotFoundInTheBody
apikey:
Cuerpo de la solicitud:
--AnyStringNotFoundInTheBody
Content-Disposition: form-data; name="params"
{"taskid":"12345","boardid":"1"}
--AnyStringNotFoundInTheBody
Content-Disposition: form-data; name="Screenshot.png"; filename="Screenshot.png"
Content-Type: image/png
[binary image data]
--AnyStringNotFoundInTheBody--

Archivar tarea [archive_task]


Necesario cardid
  Id o ids de las tarjetas que se archivarán. Las tarjetas no deben estar bloqueadas, en la columna Terminado o en la columna Archivo.
Opcional version
  Versión del archivo. Cuando se selecciona, no puede estar vacía, tampoco puede ser una matriz de valores.
Salida status
  Estado 1 (Verdadero) si la operación fue exitosa o Error si Falso.
 
 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/archive_task
Cuerpo de la solicitud: {"cardid":[17,321], "version":"name-of-the-versions"}

Editar campos personalizados [edit_custom_fields]


Necesario cardid fields fields[][name] fields[][value]
  La id de la tarjeta para la que desea aplicar el campo personalizado. El campo personalizado ya debería haber sido creado. Una matriz de campos personalizados. El nombre del campo personalizado. Debe coincidir con el campo personalizado válido por tablero. El valor del campo personalizado. El tipo de valor debe ser el mismo que el de la declaración de campo personalizado.
Opcional n/a
   
Salida status
  Estado 1 (Verdadero) si la operación fue exitosa o Error cuando Falso!

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/edit_custom_fields 
Cuerpo de la solicitud: {"cardid":"17", "fields":[{"name":"price", "value":"233"}, {"name":"mail", "value":"ex@test.com"}]}

Obtener Adjunto [get_attachment]


Usa esta opción para descargar archivos adjuntos.

Necesario taskid uniquename
 

La ID de la tarjeta que contiene el archivo adjunto.

El parámetro uniqueName del archivo adjunto. Se puede obtener a través de get_task_details o get_all_tasks.

Opcional thumbnail encoding
  Selecciona “sí” si deseas obtener una miniatura del archivo adjunto original. Válido solo para archivos de imagen. Especifica la codificación en la que devolver el archivo. Los formatos admitidos son ‘binary’ y ‘base64’. El valor predeterminado es ‘binario’. Ten en cuenta que si se produce algún error, el formato de respuesta está determinado por el parámetro URL ‘formato’.
Salida  Datos adjuntos o error.

https://.kanbanize.com/index.php/api/kanbanize/get_attachment/
Cuerpo de la solicitud: {"taskid":"27", "uniquename":"uniqueNameOfTheFile.txt"}

Obtener tareas con tiempo de registro [get_tasks_with_log_time]


 

Required fromdate todate
  La fecha después de la cual ocurrieron las actividades de interés. Acepta los siguientes formatos: ‘2012-05-05 ′, ’10 September 2012’. La fecha antes de que ocurrieron las actividades de interés. Acepta los siguientes formatos: ‘2012-05-05 ′, ’10 September 2012’.
Optional author boardid
  El usuario que realizó las actividades. El valor predeterminado es ALL. La identificación del tablero donde se encuentran las tarjetas.
Salida taskid position type assignee title description color priority size deadline extlink tags columnid laneid blocked blockedreason columnname lanename subscribers boardparent attachments workflow loggedtime loggedtime[][author] loggedtime[][date] loggedtime[][loggedinsubtask] loggedtime[][loggedtime]
  La identificación de la tarea La posición de la tarjeta en su columna actual El tipo de tarea Nombre de usuario del asignado Título de la tarea Descripción de la tarea Color de la tarea Prioridad de la tarea Tamaño de la tarea Fecha tope de la tarea en formato aaaa-mm-dd (por ejemplo, 2012-08-01) Еnlace externo de la tarea Etiquetas de la tarea La identificación de la columna en la que se encuentra la tarea La identificación del carril en el que se encuentra la tarea La tarea está bloqueada (0 – no / 1 – sí) Por qué se bloquea la tarea El nombre de la columna en la que se encuentra la tarea El nombre del carril en el que se encuentra la tarea Observadores de la tarjeta La identificación del tablero donde se encuentra la tarea Registro con la información sobre los archivos adjuntos a la tarjeta El flujo de trabajo al que pertenece el elemento (0 – flujo de trabajo de tarjetas / 1 – flujo de trabajo de iniciativas) Los registros de tiempo registrado Quien realizó la acción Para cuando se registró el tiempo Si el tiempo fue registrado en subtarea El número de horas registradas

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_tasks_with_log_time/
Request body: {"fromdate": "2018-06-14", "todate": "2018-08-29"}

Obtener actividades del tiempo registrado [get_log_time_activities]


 

Obligatorio fromdate todate
  La fecha después de la cual ocurrieron las actividades de interés. Acepta los siguientes formatos: ‘2012-05-05 ′, ’10 September 2012’. La fecha antes de que ocurrieron las actividades de interés. Acepta los siguientes formatos: ‘2012-05-05 ′, ’10 September 2012’.
Opcional author
  El usuario que realizó las actividades. El valor predeterminado es ALL.
Salida author date cardid columnname boardid loggedinsubtask loggedtime cardtitle cardtype
  Quien realizó la acción. Para cuando se registró el tiempo. La identificación de la tarjeta o subtarea en la que se registró el tiempo. Nombre de la columna en la que se registró el tiempo. La identificación del tablero donde el tiempo se ha registrado. Si el tiempo fue registrado en subtarea. El número de horas registradas. Título de la tarjeta en que se ha registrado el tiempo. Tipo de tarjeta en la que se ha registrado el tiempo.

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_log_time_activities/
Request body: {"fromdate": "2018-06-14", "todate": "2018-08-29"}

Poderoso, ¿verdad? ¡Pruébalo tú mismo gratis ahora!

La cuenta de prueba en Kanbanize brinda acceso a todas las características del sistema casi sin restricciones. Durante el período de prueba de 30 días, puede invitar a su equipo y probar la aplicación en un entorno de producción similar.

Una Plataforma Digital para Tarjetas Kanban Clásicas

La gestión de productos Kanban es un sistema probado que usan las empresas y equipos más exitosos del mundo. Este sistema se basa en las tarjetas para dividir proyectos grandes y complejos en piezas más pequeñas y manejables.

Kanbanize usa tableros digitales que tienen tarjetas Kanban. Estas tarjetas os dan a ti y a tu equipo la capacidad de:

  • Mover las tarjetas a través del tablero Kanban para que los equipos puedan visualizar el progreso
  • Limitar la cantidad de tarjetas entregadas a un usuario, otorgando a cada miembro del equipo una carga de trabajo manejable para una eficiencia máxima
  • Crear diferentes tipos de tarjetas, permitiendo a los usuarios ver únicamente las tarjetas que son relevantes para su trabajo
  • Utilizar plantillas de tarjetas Kanban que tengan atributos y subtareas predefinidos
  • Definir campos personalizados que puedes establecer como obligatorios u opcionales

Nuestra tarjeta del tablero Kanban es una representación moderna y digital de las clásicas tarjetas Kanban que hicieron famoso al sistema. Como usuario, obtienes un sistema probado y confiable de productividad y eficiencia en una plataforma digital que suma funcionalidad.

Muchas empresas de software están tratando de capitalizar el legado de la gestión Kanban. Algunos proveedores de software Kanban ofrecen las herramientas que necesitas, pero en una interfaz que es difícil de dominar. Otros ofrecen un software fácil de usar que carece de las herramientas que necesitas para obtener la máxima productividad y eficiencia. Kanbanize ofrece el mejor sistema y tarjetas Kanban por una simple razón: ofrecemos una serie profunda y poderosa de características en una interfaz fácil de usar que permite una adopción rápida.

Elige Kanbanize y disfruta de un aumento en la productividad de hasta 300%. Si deseas probar nuestras tarjetas Kanban, aprovecha una prueba gratuita de 30 días. Descubrirás rapidamente las ventajas y los beneficios que Kanbanize puede proporcionar a los equipos y empresas de cualquier tamaño.

COMENZAR →

¡Únete a nuestra familia!
  • Continental Corporation
  • Mozilla
  • BCG Digital Ventures
  • Tokyo Electron
  • Bose
  • Indiana University
  • Orange Business Services
  • GoDaddy
  • Arsenal Football Club
  • Roche Diagnostics

Siempre contigo, sobre la marcha

Accede a todos tus proyectos y tableros sobre la marcha con nuestras aplicaciones móviles. Ve, crea, actualice, elimina y mueve tarjetas, publica comentarios y más con nuestras aplicaciones móviles.