Accordo API per sviluppatori e servizi aziendali

Ultimo aggiornamento: 3/30/2026

Il presente Contratto per API per sviluppatori e servizi aziendali (il "Contratto API") disciplina l'accesso e l'utilizzo delle API e delle funzionalità aziendali di Ship a Postcard LLC. Creando una chiave API o accedendo agli Spazi di lavoro del team, l'utente ("Sviluppatore" o "Cliente aziendale") accetta i presenti termini in aggiunta ai nostri Termini di servizio standard.

1. Descrizione del servizio e licenza

Ship a Postcard LLC fornisce un'API REST e un'interfaccia No-Code (tramite Zapier/Webhooks) per consentire la generazione automatizzata e la distribuzione fisica di cartoline. L'azienda concede allo sviluppatore una licenza revocabile e non esclusiva per integrare i nostri servizi nelle proprie applicazioni o flussi di lavoro interni.

2. Logica di elaborazione giornaliera dei lotti e dei pagamenti

La piattaforma utilizza un modello di elaborazione "Daily Batch" per ottimizzare l'evasione degli ordini e ridurre al minimo i costi di transazione.

  • Ciclo batch: le singole richieste API vengono messe in coda e mantenute nello stato pending_batch . Il processo notturno ProcessDailyBatches viene eseguito una volta al giorno (in genere alle 00:00 EST).
  • Fatturazione consolidata: per gli account B2B/Enterprise, gli ordini convalidati entro un ciclo di 24 ore vengono addebitati come un'unica campagna o un unico lotto di campagne.
  • Annullamenti: Gli ordini possono essere modificati o eliminati tramite API in qualsiasi momento finché si trovano nello stato pending_batch . Una volta avviato il processo ProcessDailyBatches , gli ordini vengono trasmessi ai nostri partner di stampa (Lob.com) e non possono essere annullati, modificati o rimborsati.
  • Articoli non elaborati : Se singole cartoline all'interno di un lotto non vengono elaborate a causa di indirizzi non validi o errori API, verrà emesso un credito sul saldo dell'account dello sviluppatore da utilizzare per campagne future.

3. Limiti di utilizzo e limitazione della velocità

Per garantire la stabilità del sistema, Ship a Postcard LLC utilizza la limitazione della frequenza delle richieste.

  • Limiti standard: salvo diverso accordo in un modulo d'ordine aziendale, l'accesso è limitato a 10 richieste al secondo.
  • Codici di risposta : il superamento di questi limiti comporterà una risposta HTTP 429 (Troppe richieste).
  • Abuso: Eludere i limiti di frequenza o utilizzare l'API per l'invio massivo di "Postcard Spam" costituisce una violazione dei presenti termini e comporterà l'immediata revoca della chiave API.

4. Spazi di lavoro di gruppo e controllo degli accessi basato sui ruoli (RBAC)

Gli account aziendali possono utilizzare gli spazi di lavoro di gruppo con controllo degli accessi basato sui ruoli (RBAC).

  • Responsabilità dell'amministratore: L'amministratore dello spazio di lavoro è legalmente e finanziariamente responsabile di tutti gli ordini effettuati dai membri del team invitati.
  • Isolamento dei dati: Ship a Postcard LLC garantisce l'isolamento dei dati all'interno di un'area di lavoro; tuttavia, l'amministratore riconosce di avere piena visibilità su tutte le cartoline inviate dai sottoutenti all'interno della propria area di lavoro.

5. Sicurezza delle API

Lo sviluppatore è l'unico responsabile della sicurezza delle proprie chiavi API (in ambiente di produzione e di test).

  • Gestione delle credenziali: le chiavi API devono essere archiviate in modo sicuro e non devono mai essere esposte nel codice lato client.
  • Idempotenza: raccomandiamo vivamente l'utilizzo delle chiavi di idempotenza per evitare addebiti duplicati derivanti da tentativi di connessione alla rete.

6. INDENNIZZO E RESPONSABILITÀ

  • Responsabilità dei contenuti : Lo sviluppatore è l'"editore" di tutti i contenuti inviati tramite API. Lo sviluppatore si impegna a tenere indenne la Società da qualsiasi rivendicazione derivante da contenuti di cartoline che violino le leggi sul diritto d'autore, sulla privacy o sulle molestie.
  • Limitazione di responsabilità : In nessun caso Ship a Postcard, LLC sarà responsabile per danni indiretti, incidentali o consequenziali (inclusa la perdita di affari) derivanti da interruzioni dell'API, ritardi nell'elaborazione batch o errori di consegna da parte di USPS. La responsabilità totale è limitata all'importo pagato dallo Sviluppatore nei 30 giorni precedenti la richiesta di risarcimento.

7. RISOLUZIONE

Ship a Postcard LLC si riserva il diritto di sospendere immediatamente l'accesso all'API qualora l'integrazione dello sviluppatore causi instabilità del sistema, si renda responsabile di "spam tramite cartoline" o non mantenga un metodo di pagamento valido su Stripe.

🛠️ Documentazione per sviluppatori: Guida rapida

Comprensione della pipeline batch

Ship a Postcard non stampa le cartoline una per una in tempo reale. Utilizziamo invece una pipeline di elaborazione batch giornaliera ad alta efficienza .

  • Stato: in sospeso

richiesta POST all'endpoint /v1/postcards viene inoltrata correttamente , la risposta restituirà lo stato pending_batch . Ciò significa che la tua cartolina è stata inserita in modo sicuro nel nostro database.

  • L'attività notturna ( ProcessDailyBatchs )

Ogni notte alle 00:00 EST, il nostro sistema aggrega tutte le cartoline in sospeso in un unico batch di campagna. In quel momento, convalidiamo il pagamento e trasmettiamo i dati ai nostri partner di stampa globali.

  • Come annullare un ordine

È previsto un "periodo di grazia" tra il momento in cui si effettua la chiamata API e l'esecuzione notturna. Per annullare un ordine prima che venga stampato:

    1. Utilizza l' endpoint GET /v1/postcards per verificare che lo stato sia ancora pending_batch .
    2. Chiama DELETE /v1/postcards/{id} .
    3. Se la cancellazione ha esito positivo (204 No Content), non ti verrà addebitato alcun costo.

Nota per gli sviluppatori: una volta avviato il processo notturno, l' ID passerà a in_transit o printed e l' endpoint Delete restituirà un errore 403 Forbidden .