Prilagođeni konektori

Kada aplikacija koja vam treba nije u Referenci konektora, umjesto toga definirajte prilagođeni konektor — usmjerite Gate97 na vlastiti (ili bilo koji) HTTP API i koristite ga kao korak akcije u bilo kojem radnom tijeku. Prilagođeni konektori privatni su za vašu organizaciju; nitko izvan nje ne može vidjeti ili koristiti onaj koji definirate.

Definiranje konektora

Na stranici Prilagođene aplikacije, prilagođenom konektoru potrebno je:

• Naziv — kako se prikazuje posvuda na nadzornoj ploči, uključujući birač konektora u izradi radnog tijeka.
• Osnovni URL — korijen API-ja, npr. https://api.example.com.
• Vrsta autentifikacije — none, API key (šalje se kao header koji imenujete), bearer token, ili basic (korisničko ime + lozinka).
• Zadani format zahtjeva/odgovora — JSON, XML, CSV, ili obični text. Gate97 serijalizira odlazna tijela i parsira dolazne odgovore u formatu koji API stvarno koristi, tako da korak radnog tijeka i dalje može normalno mapirati polja čak i s XML ili CSV API-jem.

Nakon definiranja, prikazuje se na stranici Veze kao bilo koja ugrađena aplikacija — povežite ga s vjerodajnicama koje zahtijeva njegova vrsta autentifikacije (ili ničim, za none).

Korištenje u radnom tijeku

Prilagođeni konektor ima jednu akciju, dostupnu u izradi radnog tijeka nakon što ga odaberete kao konektor koraka:

• Metoda — GET, POST, PUT, PATCH ili DELETE.
• Putanja — dodaje se na osnovni URL, podržava predloške, npr. /orders?status={{trigger.status}}.
• Headeri — JSON objekt dodatnih headera koji podržava predloške.
• Tijelo — JSON koji podržava predloške, pretvoren u konfigurirani format prijenosa (XML/CSV/tekst) prije slanja.
• Format zahtjeva/odgovora — unaprijed popunjen zadanim vrijednostima konektora, promjenjiv po koraku.

Primanje podataka (dolazni okidač)

Prilagođeni konektor može opcionalno prihvaćati i dolazne podatke — označite Podržava dolazni okidač pri definiranju, i odaberite format u kojem će pošiljatelj slati POST ili PUT. Nakon aktivacije radnog tijeka koji ga koristi, njegov korak okidača prikazuje stvarni webhook URL, osiguran neprobojivim tokenom ugrađenim u sam URL umjesto zajedničke tajne. Sve poslano tamo parsira se prema odabranom formatu i pokreće izvršavanje — pogledajte Webhookove za potpunu mehaniku, koja se dijeli sa Stripeovim ugrađenim webhook okidačem.

SAP Business One, Pantheon ERP i WordPress

Ova tri konektora prikazuju se unaprijed imenovana na stranici Veze, ali ispod rade drukčije. SAP Business One komunicira izravno sa stvarnim API-jem za prijavu/sesiju svog Service Layera. Pantheon ERP i WordPress su, funkcionalno, unaprijed imenovani prilagođeni konektori — sami unosite URL i vjerodajnice vlastitog poslužitelja, a zatim sami izrađujete točan zahtjev u koraku radnog tijeka, isto kao kod bilo kojeg prilagođenog konektora — jer je svaka instalacija tih sustava konfigurirana dovoljno različito da nijedna jedinstvena fiksno kodirana integracija ne bi funkcionirala za sve.