Saltar para o conteúdo principal

SDK de editor "white-label"

Fabrixa white-label editor SDK - ferramenta de desenho incorporável para os seus clientes
PROGRAMADORES - SDK DO EDITOR DE MARCA BRANCA

Introduza um editor de personalização em qualquer página de produto.

SDK JavaScript incorporável. Os clientes finais personalizam o seu próprio trabalho artístico - carregam imagens, adicionar texto, posicionar, cortar - na página do seu produto, com a sua marca. Quando guardam, o SDK devolve um URL do trabalho artístico pronto para impressão que pode ser introduzido diretamente no ponto final da encomenda. Sem iframe, sem redireccionamento, sem a marca Fabrixa visível para o cliente final.

JS INCORPORADO - TEMATIZÁVEL - GANCHOS PARA EVENTOS - AGNÓSTICO EM RELAÇÃO À ESTRUTURA

O QUE O SDK FAZ

Uma tela, um gestor de activos e uma chamada de retorno para guardar.

O SDK apresenta uma tela de personalização dentro de qualquer elemento DOM que lhe seja fornecido. Os clientes finais clientes finais podem carregar ficheiros de ilustrações, adicionar camadas de texto, posicionar e cortar, pré-visualizar com o produto escolhido. Quando guardado, o SDK carrega o trabalho artístico composto para Fabrixa e devolve o URL do trabalho artístico através de uma chamada de retorno - pronto a para passar para a encomenda API.

01
CARREGAMENTO DE IMAGENS

Carregamento por arrastamento de PNG, JPG, SVG, AI, PSD. Conversão automática para formato pronto a imprimir. Avisos de resolução se o trabalho artístico do cliente for demasiado baixo para o produto escolhido.

02
CAMADAS DE TEXTO

Camadas de texto editáveis com tipos de letra pré-selecionados pela marca. Seleção de cores limitada à paleta da marca, se a especificar. Suporte para idiomas RTL.

03
PRÉ-VISUALIZAÇÃO DO PRODUTO

Pré-visualização em direto da arte no produto escolhido (t-shirt, capuz, almofada, etc.) através de maquetas de produtos. O cliente vê o que vai receber.

04
IMPRIMIR GUIAS DE LIMITES

Guias visuais que mostram zonas seguras para impressão, áreas de sangria, linhas de dobragem em produtos com vários painéis, como capas de edredão. Os clientes não podem colocar trabalhos artísticos fora da área imprimível.

05
GUARDAR → URL DO TRABALHO ARTÍSTICO

Ao guardar, o SDK compõe o desenho, carrega-o para o armazenamento Fabrixa e devolve um URL estável. Passe-o como arte_url no pedido de encomenda.

06
GANCHOS PARA EVENTOS

Retornos de chamada de evento JS para tela pronta, camada adicionada, salvar, erro, etc. Crie as suas próprias análises, testes A/B ou fluxos de integração.

INSTALAÇÃO

Duas linhas na sua página.

Agnóstico em relação à estrutura. O SDK é JS simples - funciona em React, Vue, Svelte, HTML simples, modelos Rails renderizados no servidor, em qualquer lugar.

embed.html

<script src="https://sdk.fabrixa.com/editor/v1/sdk.js"<
<div id="fbx-editor" estilo="altura:600px"></div>

<script>
const editor = FabrixaEditor.init({
  contentor: "#fbx-editor",
  chave_da_api: "pk_live_yourPublicKeyHere",
  produto_id: "prod_tee_unisex_aop",

  // Tema da sua marca
  tema: {
    cor_primária: "#E95121",
    família_de_fonte: "Inter, system-ui",
    raio_da_borda: "4px"
  },

  // Chamadas de retorno
  on_save: (trabalho artístico) => {
    // artwork.url é o URL pronto para impressão - alimentar a encomenda API
    consola.log(artwork.url, artwork.thumbnail_url);
  }
});
</script>

O chave_da_api aqui está o público chave - seguro para enviar no código do navegador. Apenas autoriza a tela do editor; a realização de encomendas reais requer a sua chave secreta no seu backend.

TEMÁTICA

Faça corresponder o SDK à identidade da sua marca.

O tema é opinativo - cor primária, família de letra, raio da margem, mais alguns tons de superfície. O editor não expõe todas as variáveis CSS de propósito; a consistência entre os sítios dos clientes é mais importante do que a personalização total.

theme.config.js
tema: {
  // Cores da marca
  cor_primária:        "#E95121",   // CTAs, estados activos
  cor de fundo:     "#FFFFFF",   // fundo da tela
  cor_da_superfície:        "#F4F4F4",   // painéis, lista de camadas
  texto_primário:         "#18202D",
  texto_secundário:       "#5C6573",

  // Tipografia
  família_de_fonte:          "Inter, system-ui, sans-serif",
  família_de_fonte_mono:     "JetBrains Mono, monoespaço",

  // Forma
  raio_da_borda:        "4px",
  estilo_do_botão:         "sólido",        // "sólido" | "contorno"

  // Comportamento
  mostrar_poder_por:      falso,         // ocultar o rodapé "Powered by Fabrixa
  enable_text_layers:   verdadeiro,
  enable_image_upload:  verdadeiro,
  tamanho_máximo_da_tela:      { largura: 4096, altura: 4096 }
}
EVENTOS

Ligar a análise, os testes A/B, os fluxos de integração.

Cada alteração significativa do estado do editor emite um evento JS. Subscreva no momento da inicialização ou anexe mais tarde através de editor.on().

eventos.js
const editor = FabrixaEditor.init({ /* ... */ });

// Editor montado e processado
editor.sobre("pronto", () => analytics.pista("editor_open"));

// Camada adicionada (imagem, texto)
editor.sobre("layer.added", (layer) => {
  análises.pista("editor_layer_added", { type: layer.type });
});

// O cliente carrega no botão guardar
editor.sobre("guardar", (trabalho artístico) => {
  // Encaminhar para o seu backend para criar a encomenda efectiva
  buscar("/api/orders", {
    método: "POST",
    corpo: JSON.stringify({
      artwork_url: artwork.url,
      product_id: "prod_tee_unisex_aop",
      tamanho: selectedSize
    })
  });
});

// Erros (ficheiro demasiado pequeno, falha no carregamento, etc.)
editor.sobre("erro", (err) => {
  // err.code é uma string estável - comute-a
  consola.error(err.code, err.message);
});
MODELO DE SEGURANÇA

Chave pública no browser, chave secreta no seu backend.

O SDK utiliza um público que é segura para ser enviada no código do cliente. Ele pode renderizar a tela, aceitar uploads e produzir um URL de arte pronta para impressão - mas não pode fazer um pedido, consultar o faturamento da conta ou ler a arte de outros clientes. arte-final de outros clientes. A colocação de pedidos acontece no back-end com o seu segredo chave.

CHAVE PÚBLICA (BROWSER)

O que pode fazer:

  • Renderizar a tela do editor
  • Carregar ficheiros de trabalhos artísticos para a tela
  • Gerar um URL para guardar o trabalho artístico (com o âmbito da sessão)
  • Ler o catálogo de produtos (só de leitura)
CHAVE SECRETA (APENAS BACKEND)

Necessário para:

  • Colocação de encomendas efectivas (POST /v1/orders)
  • Faturação da conta de leitura/escalão de volume
  • Configuração de pontos de extremidade de webhook
  • Listar ou anular encomendas existentes
ACESSO

O SDK está reservado a contas activas.

O acesso ao Editor SDK é ativado por conta. Depois de ter efectuado a sua primeira ordem de produção, pode solicitar o acesso ao SDK a partir do painel de controlo ou contactando um engenheiro de soluções. Fornecemos chaves públicas + secretas, além de um ambiente ambiente de sandbox para desenvolver a integração antes que ela toque em encomendas reais.

Os preços variam consoante o nível de volume do SDK. Fale com o departamento de vendas para obter informações específicas.

Fabrixa white-label editor SDK - ferramenta de design incorporável para plataformas
Incorporar o SDK do editor de marca branca Fabrixa - ferramenta de design para os seus clientes
PRONTO PARA INTEGRAR?

Obter acesso ao SDK.

Fale com um engenheiro de soluções para fornecer chaves SDK, configurar o seu ambiente sandbox, e analisar quaisquer requisitos de tela personalizada. O prazo de entrega do acesso ao SDK é normalmente 24 horas após uma breve revisão.

Carrinho (0 artigos)

Crie a sua conta