Gate97
Registracija

Prilagođene aplikacije

Kada aplikacija koja vam treba nije u popisu Integracije, umjesto toga definirajte prilagođenu aplikaciju — usmjerite Gate97 na vlastiti (ili bilo koji) HTTP API i koristite ga kao korak u bilo kojem robotu. Prilagođene aplikacije privatne su za vašu organizaciju; nitko izvan nje ne može vidjeti ili koristiti onu koju definirate.

Definiranje

Na stranici Prilagođene aplikacije, prilagođenoj aplikaciji potrebno je:

  • Naziv — kako se prikazuje posvuda na nadzornoj ploči, uključujući birač integracija u izradi robota.
  • 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 robota 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 integracija — povežite je s vjerodajnicama koje zahtijeva njezina vrsta autentifikacije (ili ničim, za none).

Korištenje u robotu

Prilagođena aplikacija ima jednu akciju, dostupnu u izradi robota nakon što je odaberete kao integraciju 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 prilagođene aplikacije, promjenjiv po koraku.

Primanje podataka (dolazni okidač)

Prilagođena aplikacija 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 što je robot koji je koristi na poslu, 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

Ove tri integracije prikazuju se unaprijed imenovane 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 imenovane prilagođene aplikacije — sami unosite URL i vjerodajnice vlastitog poslužitelja, a zatim sami izrađujete točan zahtjev u koraku robota, isto kao kod bilo koje prilagođene aplikacije — jer je svaka instalacija tih sustava konfigurirana dovoljno različito da nijedna jedinstvena fiksno kodirana integracija ne bi funkcionirala za sve.