Como configurar, usar (e solucionar problemas com) chaves de API para vincular integrações ao site.

Uma API (Application Programming Interface) permite que os desenvolvedores criem integrações e aplicativos que podem se conectar ao seu site do Squarespace.

Este guia fornece uma visão geral da API do Squarespace e das chaves de API exclusivas. Para obter informações detalhadas, visite a documentação do desenvolvedor da API.

Para obter ajuda com o Zapier, visite Adicionar integrações de formulários com o Zapier.

A API do Squarespace tem a seguinte disponibilidade. Saiba mais em "Escolhendo o plano certo no Squarespace":

• A API de formulários (para integração com o Zapier) está disponível nos planos Essencial, Plus, Avançado, Business, Commerce Básico e Commerce Avançado.
• A API de pedidos está disponível nos planos Essencial, Plus, Avançado e Commerce Avançado.
• A API de inventário está disponível nos planos Essencial, Plus, Avançado e Commerce Avançado.
• A API de transações está disponível nos planos Essencial, Plus, Avançado e Commerce Avançado.

Sobre a nossa API

O que você pode construir

Com nossa API, você pode criar integrações diretas com outros softwares, com uma grande variedade de casos de uso. Crie uma chave de API do Forms para usar nossa integração com o Zapier ou crie chaves de API do Commerce para criar suas próprias ferramentas personalizadas do Commerce.

Usando os dados aos quais fornecemos acesso por meio da nossa API, você pode:

• Conecte-se a um aplicativo de processamento ou envio de terceiros
• Sincronize seu inventário com outros canais de vendas ou sistemas de gerenciamento de inventário
• Enviar um e-mail de confirmação de pedido por meio de software externo
• Automatizar impressão de etiquetas de envio
• Automatizar a contabilidade
• Conectar-se à nossa integração Zapier

Para confirmar que uma integração é possível, acesse nossa documentação do desenvolvedor.

Segurança da chave de API

A chave de API exclusiva é uma string aleatória de caracteres que permite acesso autenticado à sua conta do Squarespace.

Para criar uma nova chave:

1. Abra o painel "Ferramentas para desenvolvedores"
2. Clique em Chaves de API do desenvolvedor.
3. Clique em Gerar chave.
   
4. Informe um Nome de chave.
5. Em Permissões, marque Pedidos, Formulários, Inventário ou Transações. Os Formulários estão disponíveis no plano Business ou superior. Pedidos, Inventário e Transações só estão disponíveis no plano Commerce Avançado.
6. Selecione as permissões da chave de API.
7. Clique em Avançar.
8. Copie sua chave de API exclusiva.

Quando você receber esta chave:

• Mantenha-a segura. Trate sua chave de API como trataria qualquer senha de conta.
• Copie e salve nos seus registros. Por segurança, não armazenamos sua chave de API. Não é possível recuperá-la após você fechar a janela, mas caso a perca, é sempre possível criar uma nova.

Você pode seguir essas etapas novamente para criar várias chaves.

Integração ao Zapier

Você pode conectar Blocos de Formulário, Blocos de Newsletter e Formulários de Página de Entrada à ferramenta de automação online Zapier. Isso permite que você crie Zaps, um tipo de fluxo de trabalho automatizado, que usa envios de formulário para acionar integrações adicionais do Zapier, como Slack, Trello, ConvertKit, Salesforce e muito mais. Isso pode ajudar você a economizar tempo ao conectar o Squarespace a ferramentas úteis e automatizar processos.

Para ajuda, acesse Adição de integração de formulário com o Zapier.

APIs do Commerce

Use as APIs do Commerce para sincronizar os dados de pedido, inventário e transação da sua loja com serviços de terceiros. Essa é uma ótima maneira de conectar sua loja do Squarespace a outros serviços que você usa para gerenciar sua empresa e automatizar tarefas importantes, como envio e arquivamento de impostos. Saiba mais sobre como usar essas APIs em nossa documentação do desenvolvedor:

• API de inventário – Sincronize seu inventário do Squarespace com sistemas de gerenciamento de inventário.
• API de pedidos – Sincronize seus pedidos do Squarespace com serviços de envio e processamento. Você também pode usar a API de registro de pedidos para importar pedidos de canais de vendas de terceiros.
• API de produtos - Crie, edite e remova produtos.
• API de transações – Sincronize suas transações e doações do Squarespace com serviços de contabilidade.
• API de assinaturas Webhook - Assine as notificações de sites do Squarespace.

Lembre-se:

• Não é possível usar a API Commerce para vincular um processador de pagamentos externo. Você só pode usar o Squarespace Payments, o Square como ponto de venda, o Stripe ou o PayPal para processar pedidos feitos no seu site.
• As APIs de Pedidos e Inventário foram projetadas para que os comerciantes criem suas próprias integrações personalizadas. Encontre as extensões oficiais criadas por serviços de terceiros no Squarespace Extensions.

Revogar uma chave de API

Para revogar uma chave de API, exclua-a no painel Chaves de API do Squarespace:

1. Abra o painel "Ferramentas para desenvolvedores"
2. Clique em Chaves de API do desenvolvedor.
3. Clique no ícone de lixeira ao lado da Chave de API que deseja revogar.
4. Clique em Confirmar.

A exclusão de uma chave de API interrompe a conexão entre seu site e o aplicativo ou serviço que usa a chave para acessar os dados do site. O aplicativo ou serviço ainda pode ter dados que você enviou enquanto a API estava conectada. Entre em contato diretamente com o desenvolvedor para gerenciar seus dados históricos.

Solução de problemas e suporte

Chaves de API

Recomendamos estes primeiros passos ao solucionar problemas com chaves de API:

• Veja se você está usando o tipo certo de chave de API. Por exemplo: você só pode usar a API de formulários para criar uma integração de formulários.
• Se um formulário ou pedido específico não aparecer, veja se você criou a chave de API do site correto.
• Se o formulário não aparecer no Zapier, e a chave de API for do site correta, apague o formulário no Squarespace e adicione um novo.

APIs do Commerce

Para obter ajuda para usar as APIs do Squarespace Commerce, acesse o nosso Site de Desenvolvedor, que tem documentação detalhada sobre todas as nossas APIs públicas. Se ainda tiver dúvidas, entre em contato conosco.