Resumo da API: últimas atualizações para ONLYOFFICE DocSpace e Docs
As atualizações de agosto de 2025 para as APIs DocSpace e Docs do ONLYOFFICE trazem uma nova onda de possibilidades de integração e ferramentas de desenvolvimento. Seja para criar fluxos de trabalho de documentos, plugins personalizados ou conectar o ONLYOFFICE ao seu conjunto de tecnologias existente, essas atualizações oferecem soluções práticas que economizam tempo e agilizam o desenvolvimento.
DocSpace: Exemplos de integração para API REST de backend
A atualização mais recente da API do DocSpace inclui uma abrangente exemplos de integração que demonstram casos de uso do mundo real. Não são apenas trechos de código – são soluções completas que você pode adaptar aos seus projetos.
Integrações Trello
Sincronização bidirecional de usuários. Sincronize usuários automaticamente entre os quadros DocSpace e Trello. Isso elimina a integração manual e garante a consistência da equipe em todas as plataformas. Adicione usuário do DocSpace no Trello / Adicione usuários do Trello no DocSpace
Migração de ativos. Importando cartões do Trello diretamente nas salas do DocSpace. Este cenário agiliza as transferências de projetos e centraliza a documentação.
Espelhamento da estrutura do projeto. Crie salas do DocSpace rooms diretamente no Trello com títulos correspondentes. Perfeito para manter a organização unificada do projeto. Confira o exemplo de código:
import requests
# ONLYOFFICE DocSpace configuration
ONLYOFFICE_API_HOST = "your-docspace.onlyoffice.com"
ONLYOFFICE_API_KEY = "your_onlyoffice_api_key"
# Trello configuration
TRELLO_API_KEY = "your_trello_api_key"
TRELLO_TOKEN = "your_trello_token"
TRELLO_BOARD_ID = "your_board_id"
ONLYOFFICE_HEADERS = {
"Authorization": f"Bearer {ONLYOFFICE_API_KEY}",
"Content-Type": "application/json",
"Accept": "application/json"
}
# Step 1: Get Trello board name
def get_trello_board_name(board_id):
url = f"https://api.trello.com/1/boards/{board_id}"
params = {"key": TRELLO_API_KEY, "token": TRELLO_TOKEN}
response = requests.get(url, params=params)
if response.status_code == 200:
return response.json()["name"]
else:
print(f"Trello board fetch error: {response.status_code}")
return None
# Step 2: Create a DocSpace room with board name
def create_docspace_room(room_title):
url = f"https://{ONLYOFFICE_API_HOST}/api/2.0/files/rooms"
payload = {
"title": room_title,
"roomType": 2, # Collaboration room
"private": True
}
response = requests.post(url, headers=ONLYOFFICE_HEADERS, json=payload)
if response.status_code == 200:
print(f"Room created: {room_title}")
return response.json()
else:
print(f"DocSpace room creation error: {response.status_code}, {response.text}")
return None
# Run integration
if __name__ == "__main__":
board_name = get_trello_board_name(TRELLO_BOARD_ID)
if board_name:
create_docspace_room(board_name)
Integrações de armazenamento em nuvem
Conectividade com o Dropbox. As novas integrações com o Dropbox suportam fluxos de trabalho de importação e exportação. Exportar arquivos para DocSpace usando URLs predefinidas para arquivamento ou backup. Importando arquivos diretamente em salas específicas para gerenciamento centralizado de documentos.
Automação de compartilhamento de pastas. Compartilhe pastas do Dropbox automaticamente com usuários DocSpace ou grupo de membros, criando pontes de colaboração contínuas entre plataformas.
Fluxos de trabalho do Notion e do Asana
Integração do usuário do Notion. Sincronize usuários do Notion workspace com o DocSpace, garantindo acesso consistente em todo o seu ecossistema de documentação.
Automação de projetos Asana. Gerar estruturas de salas do DocSpace Baseado em projetos Asana, com pastas criadas automaticamente para cada tarefa. Isso cria um alinhamento perfeito entre o gerenciamento de projetos e a colaboração em documentos.
Convites baseados em tarefas. Convidar automaticamente os responsáveis pelas tarefas do Asana para salas DocSpace relevantes, eliminando o gerenciamento de acesso manual.
DocSpace: SDK de plugins aprimorados
Os Plugins SDK recebe atualizações significativas com ambos amostras avançadas e básicas para acelerar o desenvolvimento de plugins.
Amostras de plugins avançados
- Plugin de filtro de extensão de arquivo. Adiciona recursos de filtragem contextual com uma interface modal limpa. Os usuários podem filtrar o conteúdo das salas por tipo de arquivo, melhorando a navegação em ambientes com muitos documentos.
- Plugin de diálogo modal. Demonstra integração de barra de ferramentas personalizada com chamadas de API de backend. Crie novos documentos diretamente da interface com parâmetros definidos pelo usuário.
- Interface do plugin de configurações. Fornece aos administradores interfaces de configuração personalizadas, permitindo um controle preciso sobre o comportamento do plugin.
Amostras de componentes básicos
Novos exemplos básicos abrangem componentes essenciais da interface do usuário:
- Plugin da API – mostra o tratamento adequado da conexão da API da plataforma.
- Componente Box – exemplos de configuração de layout e espaçamento.
- Componente Button – implementação de elementos interativos.
- Componente ComboBox – interfaces de seleção suspensa.
- Componente Text – opções de tipografia e estilo.
- Componente ToggleButton – controles de estado binários.
Esses exemplos fornecem os blocos de construção para o desenvolvimento de plugins mais complexos, com padrões de implementação claros que você pode seguir.
Novidades na API do Docs: Personalização
O novo parâmetro suggestFeature oferece controle granular sobre o elemento de interface do editor recém-adicionado.
const config = {
editorConfig: {
customization: {
...
suggestFeature: true,
Este parâmetro controla a visibilidade do botão de menu “Sugerir um Recurso” na aba Arquivo. Defina-o como false
para implantações internas onde as sugestões de recursos não são relevantes ou mantê-las true
para manter o envolvimento do usuário com o desenvolvimento do produto.
Docs: Novos exemplos de API do Office
Para dar suporte a diversos casos de uso, introduzimos novos exemplos de criação de documentos com aplicações práticas.
- Numeração Sequencial. Melhore a navegação na tabela e a referência de linhas adicionando numeração sequencial à primeira coluna.
- Criação de tabela formatada. Formate tabelas automaticamente durante a criação, adicionando bordas, estilizando cabeçalhos e alinhando texto dentro das células. Perfeito para relatórios, exportações de banco de dados ou modelos que exigem um layout elegante e legível.
- Planilha com filtros. Gere uma planilha com filtros de cabeçalho interativos, permitindo que os usuários classifiquem e filtrem dados facilmente para navegação e análise contínuas.
- Rodapé com data e nome da empresa. Adicione automaticamente um rodapé ao seu documento com a data atual de um lado e o nome da sua empresa do outro. Ideal para formatação padrão de memorandos, relatórios, cartas e modelos.
- Tabela de largura automática. Gere um documento com uma tabela que ajusta dinamicamente as larguras das colunas para se ajustarem perfeitamente ao conteúdo.
- Lista de tarefas com marcadores. Gere um documento com uma lista com marcadores clara e organizada, perfeita para delinear tarefas, etapas ou requisitos.
Crie sua conta gratuita no ONLYOFFICE
Visualize, edite e colabore em documentos, planilhas, slides, formulários e arquivos PDF online.