Este Contrato de API para Desenvolvedores e Serviços Empresariais (o “Contrato de API”) rege o acesso e o uso da API e dos recursos empresariais da Ship a Postcard LLC. Ao criar uma chave de API ou acessar os Espaços de Trabalho da Equipe, você (“Desenvolvedor” ou “Cliente Empresarial”) concorda com estes termos, além dos nossos Termos de Serviço padrão.
1. Descrição do Serviço e Licença
A Ship a Postcard LLC fornece uma API REST e uma ponte sem código (via Zapier/Webhooks) para permitir a geração automatizada e o envio físico de cartões postais. A empresa concede ao desenvolvedor uma licença revogável e não exclusiva para integrar nossos serviços em seus próprios aplicativos ou fluxos de trabalho internos.
2. Lógica de Lote Diário e Pagamento
A plataforma utiliza um modelo de processamento em "lotes diários" para otimizar o atendimento e minimizar os custos operacionais das transações.
- Ciclo de lotes: as solicitações individuais da API são enfileiradas e mantidas com o status pending_batch . A tarefa noturna ProcessDailyBatches é executada uma vez por dia (normalmente às 00h00 EST).
- Faturamento consolidado: Para contas B2B/Empresariais, os pedidos validados dentro de um ciclo de 24 horas são cobrados como uma única campanha ou lote de campanha.
- Cancelamentos: Os pedidos podem ser modificados ou excluídos via API a qualquer momento enquanto estiverem com o status pending_batch . Assim que o processo ProcessDailyBatches for iniciado, os pedidos serão transmitidos aos nossos parceiros de impressão (Lob.com) e não poderão ser cancelados, editados ou reembolsados.
- Itens com falha : Se cartões postais individuais dentro de um lote falharem devido a endereços inválidos ou erros de API, um crédito será emitido para o saldo da conta do desenvolvedor para uso em campanhas futuras.
3. Limites de Uso e Limitação de Taxa
Para garantir a estabilidade do sistema, a Ship a Postcard LLC utiliza limitação de taxa.
- Limites padrão: Salvo acordo em contrário em um Formulário de Pedido Empresarial, o acesso é limitado a 10 solicitações por segundo.
- Códigos de resposta : Exceder esses limites resultará em uma resposta HTTP 429 (Muitas solicitações).
- Abuso: Contornar os limites de taxa ou usar a API para envio de "spam de cartão postal" em grande volume é uma violação destes termos e resultará na revogação imediata da chave da API.
4. Espaços de Trabalho em Equipe e RBAC
As contas corporativas podem utilizar Espaços de Trabalho em Equipe com Controle de Acesso Baseado em Funções (RBAC).
- Responsabilidade do Administrador: O Administrador do Espaço de Trabalho é legal e financeiramente responsável por todos os pedidos feitos por membros da equipe convidados.
- Isolamento de dados: A Ship a Postcard LLC garante que os dados dentro de um Espaço de Trabalho sejam isolados; no entanto, o Administrador reconhece que tem visibilidade completa de todos os cartões postais enviados por subusuários dentro de seu Espaço de Trabalho.
5. Segurança da API
O desenvolvedor é o único responsável pela segurança de suas chaves de API (em produção e teste).
- Gerenciamento de credenciais: as chaves de API devem ser armazenadas com segurança e nunca expostas no código do lado do cliente.
- Idempotência: Recomendamos fortemente o uso de chaves de idempotência para evitar cobranças duplicadas resultantes de novas tentativas de conexão na rede.
6. INDENIZAÇÃO E RESPONSABILIDADE
- Responsabilidade pelo Conteúdo : O desenvolvedor é o "Publicador" de todo o conteúdo enviado via API. O desenvolvedor deverá indenizar a Empresa por quaisquer reclamações decorrentes do conteúdo dos cartões postais que violem leis de direitos autorais, privacidade ou assédio.
- Limitação de Responsabilidade : Em nenhuma hipótese a Ship a Postcard, LLC será responsável por danos indiretos, incidentais ou consequenciais (incluindo perda de negócios) resultantes de indisponibilidade da API, atrasos no processamento em lote ou falhas na entrega dos Correios dos EUA (USPS). A responsabilidade total está limitada ao valor pago pelo Desenvolvedor nos 30 dias anteriores à reclamação.
7. RESCISÃO
A Ship a Postcard LLC reserva-se o direito de suspender imediatamente o acesso à API caso a integração do desenvolvedor cause instabilidade no sistema, pratique "spam de cartões postais" ou não mantenha um método de pagamento válido no Stripe.
🛠️ Documentação para desenvolvedores: Guia de início rápido
Entendendo o Pipeline de Lote
O serviço Ship a Postcard não imprime cartões um a um em tempo real. Em vez disso, utilizamos um pipeline de lotes diários de alta eficiência .
- Status: lote_pendente
Ao acessar com sucesso o endpoint POST /v1/postcards , a resposta retornará o status pending_batch . Isso significa que seu cartão está em fila de espera em nosso banco de dados.
- O trabalho noturno ( Processar lotes diários )
Todas as noites, à meia-noite (horário padrão do leste dos EUA), nosso sistema reúne todos os cartões postais pendentes em um único lote de campanha. Nesse momento, validamos o pagamento e transmitimos os dados aos nossos parceiros de impressão globais.
- Como cancelar um pedido
Você tem um "Período de Tolerância" entre o momento em que chama a API e a execução noturna. Para cancelar um pedido antes que ele seja impresso:
-
- Use o endpoint GET /v1/postcards para verificar se o status ainda é pending_batch .
- Chame DELETE /v1/postcards/{id} .
- Se a exclusão for bem-sucedida (204 Sem Conteúdo), você não será cobrado.
Nota para desenvolvedores: Assim que a tarefa noturna for iniciada, o ID passará para o estado `in_transit` ou `printed` , e o endpoint de exclusão retornará um erro 403 Forbidden .