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:
-
- Utilizza l' endpoint GET /v1/postcards per verificare che lo stato sia ancora pending_batch .
- Chiama DELETE /v1/postcards/{id} .
- 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 .