Vai al contenuto

Come crei una chiave API per l’interfaccia di programmazione?

Aggiornato il 2 min di lettura

In “Programmschnittstelle” (interfaccia di programmazione) tocca “Schlüssel anlegen” (crea chiave), scegli i permessi e conferma con il tuo codice. Il segreto tiaki lo mostra una sola volta: copialo subito.

Apri nell’app Chi può farlo? Titolare, Amministratore
In questa pagina

Tramite l’interfaccia di programmazione altri programmi (per esempio servizi di newsletter come Brevo o CleverReach, il tuo CRM oppure Zapier e Make) prelevano i tuoi contatti da tiaki, insieme alla prova del consenso.

Passo dopo passo

  1. Apri il menu del workspace (il nome dell’azienda in alto) e lì Programmschnittstelle (interfaccia di programmazione).
  2. In Schlüssel (chiavi) tocca Schlüssel anlegen (crea chiave).
  3. In Wofür? (a cosa serve?) inserisci un nome, per esempio “Brevo”.
  4. Sotto Was darf der Schlüssel? (cosa può fare la chiave?) scegli Kontakte lesen (leggere i contatti), Einwilligungen lesen (leggere i consensi) e, se serve, Kontakte anlegen und ergänzen (creare e completare contatti).
  5. Sotto Gültig (validità) scegli per quanto tempo vale la chiave, oppure läuft nicht ab (non scade).
  6. Inserisci il Bestätigungscode (codice di conferma) della tua app di autenticazione e tocca Schlüssel anlegen.
  7. Copia ora Schlüssel-ID (ID chiave) e Geheimnis (segreto) e inseriscili entrambi nel tuo programma.

Attenzione: Il segreto tiaki lo mostra solo questa volta. L’hai perso? Crea semplicemente una nuova chiave e revoca quella vecchia.

Suggerimento: Se il tuo programma chiede “utente” e “password”, usa la Schlüssel-ID come utente e il segreto come password. Se vuole un “Bearer token”, copia il campo Bearer-Token (ID.Geheimnis). Una guida con esempi la trovi in Anleitung mit Beispielen (guida con esempi).

Con Protokoll (registro) vedi ogni accesso fatto con una chiave, con Widerrufen (revoca) la blocchi subito.

Non funziona?

  • “Die Programmschnittstelle ist Teil jedes Tarifs” (l’interfaccia di programmazione fa parte di ogni piano): durante la prova è bloccata. Scegli un piano, poi potrai creare le chiavi.
  • Non vedi nessun pulsante: chiavi e webhook li configurano solo Titolari e Amministratori.
  • Il tuo programma viene rifiutato: controlla se la chiave è abgelaufen (scaduta) o widerrufen (revocata). Se hai inserito un’autorizzazione IP, lasciala vuota per Zapier e Make: i loro indirizzi cambiano.
  • Se non riesci ad andare avanti, scrivici con Fai una domanda nell’aiuto.

Articoli correlati

Hai ancora domande su questo articolo?

Scrivici: ce ne occupiamo di persona e ti rispondiamo via e-mail.

IT