Panoramica API

L'API di WhenToMeet fornisce accesso programmatico per creare e gestire eventi di pianificazione. Questa pagina copre i prerequisiti e gli elementi essenziali—per la documentazione completa degli endpoint, schemi di richiesta/risposta e test interattivi, visita il Riferimento API.

Avvio rapido

1. Ottenere l'accesso all'API

L'API richiede un abbonamento Plus o Plus Lifetime.

Vedi prezzi →

2. Creare una chiave API

  1. Vai su Impostazioni → Chiavi API
  2. Clicca su "Crea chiave API"
  3. Assegna un nome descrittivo (es. "Server di produzione")
  4. Copia la chiave immediatamente – viene mostrata solo una volta
  5. Conservala in modo sicuro (variabili d'ambiente, gestore segreti, ecc.)

3. Esplorare l'API

Visita il Riferimento API per:

  • Esplorare tutti gli endpoint disponibili
  • Visualizzare schemi di richiesta/risposta
  • Testare chiamate API in modo interattivo
  • Vedere esempi di codice

Autenticazione

Tutte le richieste richiedono un token Bearer:

Authorization: Bearer sk_tua_chiave_api_qui

Sicurezza della chiave API

FARE:

  • Memorizzare le chiavi in variabili d'ambiente o gestori di segreti
  • Usare chiavi diverse per dev/staging/produzione
  • Ruotare le chiavi periodicamente
  • Revocare immediatamente le chiavi compromesse

NON FARE:

  • Committare le chiavi nel controllo versione
  • Condividere le chiavi via email o chat
  • Incorporare le chiavi nel codice lato client
  • Riutilizzare le chiavi su più applicazioni

Limiti di velocità

LivelloLimiteFinestra
Gratuito32 richiesteTotale a vita
Plus1.000 richiesteAll'ora (continuo)
Plus Lifetime1.000 richiesteAll'ora (continuo)

Header limiti di velocità

Le risposte includono:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1736956800

Quando limitato (risposta 429):

  • Implementare backoff esponenziale
  • Controllare X-RateLimit-Reset per il tempo di reset
  • Monitorare X-RateLimit-Remaining per limitare proattivamente

Serve aiuto?

Was this page helpful?