Acuerdo de API y servicios empresariales para desarrolladores

Ultima actualización: 10/16/2026

Este Acuerdo de API para Desarrolladores y Servicios Empresariales (el “Acuerdo de API”) rige el acceso y el uso de la API y las funciones empresariales de Ship a Postcard LLC. Al crear una clave de API o acceder a los Espacios de Trabajo de Equipo, usted (“Desarrollador” o “Cliente Empresarial”) acepta estos términos, además de nuestros Términos de Servicio estándar.

1. Descripción del servicio y licencia

Ship a Postcard LLC ofrece una API REST y una plataforma sin código (mediante Zapier/Webhooks) para la generación automatizada y el envío físico de postales. La empresa otorga al desarrollador una licencia revocable y no exclusiva para integrar nuestros servicios en sus propias aplicaciones o flujos de trabajo internos.

2. Lógica de procesamiento y pago diario por lotes

La plataforma utiliza un modelo de procesamiento por lotes diarios para optimizar la gestión de pedidos y minimizar los costes de transacción.

  • Ciclo de procesamiento por lotes: Las solicitudes individuales a la API se ponen en cola y se mantienen en estado pending_batch . El proceso nocturno ProcessDailyBatches se ejecuta una vez al día (normalmente a las 12:00 AM EST).
  • Facturación consolidada: Para cuentas B2B/empresariales, los pedidos validados dentro de un ciclo de 24 horas se facturan como una sola campaña o lote de campañas.
  • Cancelaciones: Los pedidos pueden modificarse o eliminarse a través de la API en cualquier momento mientras se encuentren en estado pending_batch . Una vez que se inicia el proceso ProcessDailyBatches , los pedidos se transmiten a nuestros socios de impresión (Lob.com) y no se pueden cancelar, editar ni reembolsar.
  • Artículos fallidos : Si alguna postal individual dentro de un lote falla debido a una dirección incorrecta o errores de la API, se emitirá un crédito al saldo de la cuenta del desarrollador para que lo utilice en futuras campañas.

3. Límites de uso y limitación de velocidad

Para garantizar la estabilidad del sistema, Ship a Postcard LLC utiliza la limitación de velocidad.

  • Límites estándar: Salvo acuerdo contrario en un formulario de pedido empresarial, el acceso está limitado a 10 solicitudes por segundo.
  • Códigos de respuesta : Si se superan estos límites, se recibirá una respuesta HTTP 429 (Demasiadas solicitudes).
  • Abuso: Eludir los límites de uso o utilizar la API para enviar "spam postal" de gran volumen constituye una violación de estos términos y dará lugar a la revocación inmediata de la clave API.

4. Espacios de trabajo en equipo y RBAC

Las cuentas empresariales pueden utilizar espacios de trabajo en equipo con control de acceso basado en roles (RBAC).

  • Responsabilidad del administrador: El administrador del espacio de trabajo es legal y financieramente responsable de todos los pedidos realizados por los miembros del equipo invitados.
  • Aislamiento de datos: Ship a Postcard LLC garantiza que los datos dentro de un espacio de trabajo estén aislados; sin embargo, el administrador reconoce que tiene visibilidad completa de todas las postales enviadas por los subusuarios dentro de su espacio de trabajo.

5. Seguridad de la API

El desarrollador es el único responsable de la seguridad de sus claves API (tanto en producción como en pruebas).

  • Gestión de credenciales: Las claves API deben almacenarse de forma segura y nunca deben exponerse en el código del cliente.
  • Idempotencia: Recomendamos encarecidamente el uso de claves de idempotencia para evitar cargos duplicados resultantes de reintentos de red.

6. INDEMNIZACIÓN Y RESPONSABILIDAD

  • Responsabilidad del contenido : El desarrollador es el "editor" de todo el contenido enviado a través de la API. El desarrollador indemnizará a la empresa contra cualquier reclamación derivada del contenido de las postales que infrinja las leyes de derechos de autor, privacidad o acoso.
  • Limitación de responsabilidad : En ningún caso Ship a Postcard, LLC será responsable por daños indirectos, incidentales o consecuenciales (incluida la pérdida de negocio) derivados de la inactividad de la API, retrasos en el procesamiento por lotes o fallos en la entrega del servicio postal. La responsabilidad total se limita al importe pagado por el desarrollador en los 30 días anteriores a la reclamación.

7. TERMINACIÓN

Ship a Postcard LLC se reserva el derecho de suspender el acceso a la API de inmediato si la integración del desarrollador causa inestabilidad en el sistema, participa en el envío de "spam de postales" o no mantiene un método de pago válido en Stripe.

🛠️ Documentación para desarrolladores: Guía de inicio rápido

Comprender el flujo de procesamiento por lotes

Ship a Postcard no imprime tarjetas una por una en tiempo real. En su lugar, utilizamos un sistema de procesamiento por lotes diario de alta eficiencia .

  • Estado: lote_pendiente

Cuando acceda correctamente al endpoint POST /v1/postcards , la respuesta devolverá el estado pending_batch . Esto significa que su tarjeta se encuentra en cola de forma segura en nuestra base de datos.

  • El trabajo nocturno ( Procesar lotes diarios )

Cada noche a las 12:00 AM EST, nuestro sistema agrupa todas las postales pendientes en un único lote de campaña. En ese momento, validamos el pago y transmitimos los datos a nuestros socios de impresión globales.

  • Cómo cancelar un pedido

Tienes un "período de gracia" entre el momento en que llamas a la API y la ejecución nocturna. Para cancelar un pedido antes de que se imprima:

    1. Utilice el punto final GET /v1/postcards para verificar que el estado siga siendo pending_batch .
    2. Llamar a DELETE /v1/postcards/{id} .
    3. Si la eliminación se realiza correctamente (código 204 Sin contenido), no se le cobrará nada.

Nota para desarrolladores: Una vez que comience el trabajo nocturno, el ID pasará a estar en tránsito o impreso , y el punto final de eliminación devolverá un error 403 Prohibido .