Marketing
Canva no seu produto e nos seus agentes de IA, por uma API
O toolkit do Canva cobre designs (listar, consultar e criar), exportações para PDF, JPG, PNG, PPTX, GIF ou MP4, conteúdo de pastas e assets, incluindo envio a partir de uma URL pública. O cliente conecta o Canva uma vez por OAuth no seu próprio app, e o Connect mantém os tokens renovados e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/canva_create_design/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"type": "type_and_asset"
}
}Como funciona
Do cliente conectado à primeira chamada no Canva.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Canva. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Canva.
Exportar designs para arquivos
Inicie a exportação de um design como PDF ou PNG, consulte Get design export até o status ser success e entregue os arquivos ao usuário dentro do seu produto.
Abrir o design certo
Liste os designs do usuário e mostre títulos, miniaturas e urls de edição, ou crie um design novo a partir de um design_type ou de um asset_id existente.
Alimentar a biblioteca de marca
Envie logos e imagens de URLs públicas para os Uploads do usuário e renomeie ou re-etiquete com Update asset, pelo seu produto ou por um agente de IA.
Tools
12 tools do Canva
- Listar designsGETLista os designs dos projetos do usuário e os compartilhados com ele, com id, title, thumbnail, page_count e as urls de edição e visualização. Quando a resposta traz continuation, envie-o como continuation para ler a próxima página.
- Consultar designGETRetorna um design com título, proprietário, miniatura, page_count e as urls de edição e visualização. Essas urls são temporárias e abrem apenas para o usuário conectado.
- Criar designPOSTCria um design e o retorna com id e as urls de edição e visualização. Envie design_type, asset_id ou ambos. Um design em branco que ninguém edita em 7 dias é apagado definitivamente, sem ir para a lixeira.
- Listar formatos de exportaçãoGETLista os formatos para os quais um design pode ser exportado, que dependem do tipo e das páginas. Um formato com page_numbers vale apenas para essas páginas.
- Criar exportação de designPOSTInicia a exportação de um design como PDF, JPG, PNG, PPTX ou GIF e retorna o job com seu id. Chame Get design export até o status ser success: as urls dos arquivos valem por 24 horas. Cada usuário pode exportar 75 vezes a cada 5 minutos e 500 vezes por dia.
- Criar exportação de design em vídeoPOSTInicia a exportação de um design como vídeo MP4 e retorna o job com seu id. Chame Get design export até o status ser success: as urls dos arquivos valem por 24 horas. Cada usuário pode exportar 75 vezes a cada 5 minutos e 500 vezes por dia.
- Consultar exportação de designGETRetorna um job de exportação: status in_progress, success ou failed e, com success, as urls dos arquivos, uma por página conforme o formato, válidas por 24 horas. Chame de novo, com esperas crescentes, enquanto o status for in_progress.
- Listar itens da pastaGETLista as pastas, os designs e as imagens de uma pasta, cada um com seu tipo, o objeto de pasta, design ou imagem e seu id. Vídeos não são listados. Quando a resposta traz continuation, envie-o como continuation para ler a próxima página.
- Consultar assetGETRetorna um asset com nome, tags, miniatura, proprietário e datas.
- Atualizar assetPATCHAtualiza o nome ou as tags de um asset e o retorna. As tags enviadas substituem todas as tags atuais.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/canva, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
Perguntas sobre o toolkit do Canva
Preciso implementar a API do Canva?
Não. O Connect já traz 12 tools do Canva descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Canva?
Pelo modo que o toolkit aceita: OAuth com o app do seu produto. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
