API de la Zapier: Efectuați apeluri API de ieșire securizate | Zapier

Zapier se conectează la mii de aplicații, dar poate că o aplicație sau o acțiune de care aveți nevoie nu este disponibilă sau o integrare nativă nu vă permite să setați domenii OAuth. Fără ele, IT-ul ar putea să nu aprobe integrarea pe care o doriți.

În trecut, a existat o singură soluție: să inserați cheia API pentru aplicația dorită Webhooks de Zapier trepte. Dar asta face cheile vizibile pentru oricine vă poate vizualiza Zap (ceea ce numim un flux de lucru automat). Dacă cineva cu acces primește phishing sau reutiliza o parolă, nu există nimic între atacator și cheile tale.

API de la Zapier este o modalitate mai nouă și mai sigură de a efectua apeluri API de ieșire autentificate către orice punct final. Continuați să derulați pentru a afla cum funcționează, modurile în care îl puteți utiliza și de ce este un însoțitor, nu un înlocuitor, pentru Webhooks by Zapier.

Cuprins

Ce este API by Zapier?

API by Zapier este un instrument încorporat care vă permite să automatizați aplicațiile fără o integrare nativă Zapier. Face cereri HTTP autentificate din interiorul unui Zap, cu acreditările stocate într-o conexiune, mai degrabă decât în ​​pasul Zap în sine. Și acceptă GET, POST, PUT, PATCH și DELETE, astfel încât să puteți citi, crea, actualiza sau elimina înregistrări pentru orice punct final care acceptă aceste metode.

Când construiți o conexiune în API by Zapier, aceasta este legată de o anumită aplicație și persoană. Puteți alege metoda de autentificare: fără autentificare, un token static (cheie API sau purtător) sau OAuth 2.0 cu propriile acreditări și domenii ale clientului.

Acreditările trăiesc în conexiune – nu Zap – și sunt injectate în timpul execuției, astfel încât colegii de echipă care văd Zap nu le văd niciodată. Asta contează mai mult decât ar suna – și nu are nimic de-a face cu faptul că ai încredere în colegii tăi (sunt sigur că sunt minunați).

Acreditările în text simplu se scurg prin capturi de ecran, partajări de ecran și partajări accidentale cu contractori sau parteneri. Dacă cineva intră într-un cont prin phishing, umplere de acreditări, o parolă reutilizată sau o sesiune de browser deturnată, poate doar să citească cheia imediat după pas.

Conexiunile de persoană facilitează, de asemenea, debarcarea. În mod normal, veți parcurge fiecare pas de webhook-uri din Zap-urile dvs. pentru a găsi care folosesc acreditările unui coechipier care pleacă și care se vor rupe când pleacă. Cu API by Zapier, acreditările trăiesc în propria lor conexiune, vizibile pe o singură pagină, astfel încât să știți exact ce să revocați.

Fiecare conexiune este, de asemenea, încadrată într-un filtru de domeniu – o listă permisă de nume de gazdă la care poate ajunge conexiunea. Acreditările se deplasează numai către adresele pe care le-ați aprobat. De exemplu, să presupunem că creați o conexiune cu cheia API HubSpot și setați filtrul de domeniu la api.hubspot.com. Dacă cineva indică acea conexiune către o adresă URL diferită (cum ar fi un server pe care îl controlează), Zapier va refuza să trimită cererea. Cheia ta nu părăsește niciodată clădirea. Fără un filtru de domeniu, aceeași solicitare s-ar declanșa.

Aceasta este o adevărată plasă de siguranță împotriva furtului de acreditări, a configurării greșite accidentale și a deformarii domeniului de aplicare. Chiar dacă cineva obține acces la conexiune, nu o poate redirecționa. Dacă cineva inserează adresa URL greșită într-un pas, conexiunea nu se va declanșa împotriva unui serviciu neintenționat. Și o conexiune construită pentru un scop nu poate fi reutilizată în liniște pentru altul.

De asemenea, puteți seta o adresă URL de testare opțională, astfel încât Zapier să poată verifica funcționarea conexiunii înainte de a construi cu ea. Pentru administratori, API by Zapier apare pe Conexiuni la aplicație ca orice altă aplicație, astfel încât să puteți gestiona accesul, să restricționați aplicația în echipa dvs. Dacă ești pe un Planul de întreprindereputeți folosi comenzile aplicațiilor gestionate pentru a stabili cine poate crea și utiliza conexiuni.

În cele din urmă, API-ul Zapier nu se limitează la cererile de ieșire. De asemenea, poate declanșa Zaps prin sondajul unui punct final conform unui program – util oricând trebuie să „ascultați” un API care nu trimite webhook-uri, cum ar fi un instrument de raportare sau de analiză.

Caracteristicile cheie ale API-ului Zapier includ:

• Autentificare flexibilă: Conectați-vă fără autentificare, chei API sau jetoane purtător sau OAuth 2.0 cu propriile date de conectare și domenii de aplicare.

• Stocare securizată a acreditărilor: Acreditările se află în conexiune, nu în Zap, și sunt injectate în timpul execuției, astfel încât să nu apară niciodată în intrările de pas sau în jurnalele.

• Filtrarea domeniului: Fiecare conexiune este blocată la domeniile pe care le specificați, astfel încât acreditările pot fi trimise numai acolo unde le-ați autorizat.

• Guvernare administrativă: Gestionați conexiunile de la Conexiuni la aplicație pagina, restricționați aplicația în echipa dvs. și controlați partajarea cu funcțiile gestionate ale aplicației pentru Enterprise.

Webhooks vs. API by Zapier: Care este diferența?

Ambele instrumente vă permit să vorbiți cu API-uri care nu au o integrare nativă Zapier, dar le-ați folosi în diferite situații.

Utilizați Webhooks by Zapier dacă:

• Prindeți date de intrare. Ai nevoie de un serviciu extern pentru Apăsaţi informații către Zap-ul dvs. (prin cârlig de prindere sau cârlig brut). API de la Zapier poate declanșa și Zaps, dar face acest lucru prin sondaj, contactând un program pentru a verifica dacă există date noi, în loc să le primească pasiv.

• Nu este nevoie de autentificare. Punctul final pe care îl apelați este public sau deja securizat într-un alt mod (cum ar fi o listă de IP permisă), deci nu există acreditări de protejat. API by Zapier acceptă și o opțiune „fără autentificare”, dar Webhooks are o configurare mai simplă, cu mai puține câmpuri de configurat.

• Trebuie să trimiteți date codificate în formular. Webhooks vă permite să alegeți un format de corp (form, JSON, brut) și câmpuri de hartă cu o interfață simplă de utilizare a numelui-valoare.

• Aveți deja Zaps care rulează cu Webhooks. Dacă acest lucru este adevărat, nu este nevoie să vă reconstruiți Zaps-urile dacă funcționează bine. Treceți la API by Zapier numai atunci când creați ceva nou sau atunci când problemele de securitate merită.

Utilizați API by Zapier dacă:

• Solicitarea dvs. necesită autentificare. Chei API, jetoane purtător, OAuth 2.0 — API by Zapier le stochează într-o conexiune sigură, nu în pasul Zap. Nimeni care vizualizează sau editează Zap-ul nu vă poate vedea secretele.

• Doriți să reutilizați acreditările în Zaps. Configurați conexiunea o dată, apoi utilizați-o în câte instrumente Zaps sau MCP aveți nevoie. Nu mai lipiți aceeași cheie de cinci ori.

• Probleme de securitate sau de conformitate. Filtrele de domeniu blochează fiecare conexiune la nume de gazdă aprobate, astfel încât acreditările dvs. să nu poată fi redirecționate undeva în mod neașteptat. Administratorii pot gestiona și restricționa conexiunile dintr-o singură pagină.

• Ești într-o echipă. Conexiunile de persoană înseamnă că știți întotdeauna ale cui acreditări sunt utilizate. Când cineva pleacă, știi exact ce să revoci și unde să-l găsești fără a căuta pașii Zap individuali.

Ce puteți face cu API by Zapier

Iată câteva idei pentru a pune în funcțiune API-ul de la Zapier:

Postați noi detalii de oportunitate Salesforce pe un canal Slack

Doriți să vă alertați echipa de vânzări Slack când apare o nouă oportunitate Salesforcedar trageți un câmp personalizat pe care acțiunea încorporată a integrării native Slack nu îl expune.

Cum ar putea arăta:

1. Zap-ul dvs. se declanșează atunci când se primește un nou mesaj de ieșire de la Salesforce.

2. API by Zapier apelează un punct final personalizat REST Salesforce pentru a extrage valorile câmpurilor personalizate de care aveți nevoie.

3. Slack postează un rezumat formatat pe canalul dvs. de deal.

Înregistrați noile elemente API într-un depozit de date BigQuery

Doriți să extrageți înregistrări dintr-un API de furnizor de nișă care nu are integrare Zapier și să le stocați în depozitul dvs. de date pentru analiză. Dar nu doriți să construiți o integrare privată pe Platforma pentru dezvoltatori doar pentru a citi un singur punct final.

Cum ar putea arăta:

1. API by Zapier sondajează punctul final al furnizorului într-un program și preia noi înregistrări folosind o cheie de deduplicare.

2. Formatator de Zapier curăță valorile câmpurilor, normalizând majusculele, eliminând spațiile albe și reformatând datele.

3. Google BigQuery adaugă înregistrarea curățată la tabelul de depozit ca un rând nou.

Această diagramă vizuală a fost creată în Zapier Canvasinstrumentul nostru încorporat gratuit pentru cartografierea fluxurilor dvs. de lucru automate.

Furnizați noi angajați BambooHR în sistemele interne

Vrei fiecare angajare nouă BambooHR să fie furnizat automat în sistemele dumneavoastră interne și HRIS, cu o cale diferită pentru contractori față de angajații cu normă întreagă.

Cum ar putea arăta:

1. Zap-ul tău se declanșează atunci când un nou angajat este adăugat la BambooHR.

2. O pas de filtrare oprește Zap-ul cu excepția cazului în care statutul angajatului este activ.

3. API by Zapier apelează API-ul de furnizare internă pentru a crea contul de utilizator.

4. Formatter de la Zapier transformă tipul de angajare în formatul pe care îl așteaptă sistemele dvs. din aval.

5. O pas de cale împarte Zap în funcție de tipul de angajare.

   1. Pentru angajații cu normă întreagă, Zi de lucru creează o înregistrare a angajaților cu normă întreagă în HRIS.

   2. Pentru antreprenori, Slack dă un ping IT cu detaliile contractorului pentru revizuire manuală.

##toc-cum

Cum să începeți cu API by Zapier

Configurația de mai jos acoperă Zaps, dar configurarea în Zapier MCP funcționează în același mod. Rețineți că declanșatorul API by Zapier nu este disponibil în Zapier MCP, deoarece „declanșatorul” dintr-un flux de lucru MCP este întotdeauna să faceți o solicitare în instrumentul dvs. AI.

Declanșați solicitări API în Zaps

1. Conectați-vă la Zapier și mergeți la Editor Zap.

2. Căutați și selectați API de la Zapierapoi alegeți Articol nou din API eveniment de acțiune.

   

3. Clic Selecta apoi + Conectați un cont nou. Aceasta va deschide o fereastră care arată astfel.

   

   Selectați un tip de autentificare și un filtru de domeniu. În funcție de tipul de autentificare pe care l-ați ales, completați Anteturi statice câmp sau derulați în jos și completați OAuth2 câmpuri. Când ați terminat, faceți clic Conectați-vă.

4. Apoi, configurați declanșatorul selectând metoda HTTP și adresa URL. Acesta din urmă ar trebui să se potrivească cu filtrul de domeniu introdus la pasul anterior. De asemenea, puteți adăuga parametri de interogare, anteturi sau un corp dacă API-ul are nevoie de ei. Sub aceasta, veți vedea câmpuri pentru a Filtru de răspuns şi Cheie de dedublare. Acestea îi spun lui Zapier unde să găsească elemente în răspuns și cum să identifice altele noi. Acestea sunt livrate cu valori prestabilite care funcționează pentru majoritatea API-urilor, așa că le puteți sări peste ele pentru a începe.

   

5. Testați-vă pasul pentru a vă asigura că funcționează corect. Apoi continuați să adăugați câte acțiuni aveți nevoie. Nu uitați să testați Zap-ul și să publicați când este gata.

Trimiteți solicitări API în Zaps

1. Conectați-vă la Zapier și mergeți la Editor Zap.

2. Căutați aplicația de declanșare și selectați evenimentul dorit. Acestea sunt datele cu care va începe Zap. Dacă nu adăugați pași între ele, este ceea ce va fi transmis direct la solicitarea API.

3. Acum adăugați un pas de acțiune. Căutați și selectați API de la Zapier. Apoi alegeți Solicitare API eveniment de acțiune.

   

4. Clic Selecta apoi + Conectați un cont nou. Aceasta va deschide o fereastră care arată astfel.

   

   Selectați un tip de autentificare și un filtru de domeniu. În funcție de tipul de autentificare pe care l-ați ales, completați Anteturi statice câmp sau derulați în jos și completați OAuth2 câmpuri. Când ați terminat, faceți clic Conectați-vă.

5. Configurați cererea. Alegeți metoda HTTP, introduceți adresa URL a punctului final și creați anteturi, parametrii de interogare și corpul solicitării, după cum este necesar.

   

6. Adăugați orice pași suplimentari de acțiune de care aveți nevoie fluxul de lucru, cum ar fi Filtrați după Zapier, Formatator de Zapier, Cărări de Zapiersau aplicația din aval unde ar trebui să ajungă datele.

7. Când ați terminat, nu uitați să testați și să porniți Zap-ul.

Apelați orice API în siguranță cu API by Zapier

API by Zapier vă oferă o modalitate mai sigură și mai flexibilă de a ajunge la orice punct final dintr-un instrument Zap sau MCP – fără acreditări în text simplu, nu este necesară construirea unei aplicații personalizate și nu este nevoie să așteptați o integrare nativă.

Ești gata să te scufunzi? Vizitați Pagina de integrare API by Zapier pentru inspirație sau a noastră ghid de ajutor pentru mai multe îndrumări.