Google Docs

A1Connection architecture

The connection uses OAuth 2.0 against the vendor's own consent screen. The authorisation request names the minimum scopes the features need — the exact scope list is shown in the security-flow panel below, pulled from the same provider registry the application uses. The code-for-token exchange happens entirely server-side (mga kredensyal ng kliyente sa katawan ng kahilingan sa token, per the vendor's token endpoint contract); tokens are stored encrypted at rest and are never rendered back to any screen — connection pages show presence, not values.

Ang ikot ng buhay ng token ay hinahawakan sa isang solong chokepoint: ang pag-expire ay nag-trigger ng awtomatikong pag-refresh, ang mga pinaikot na refresh token ay pinipilit, at ang pag-refresh na tinanggihan ng vendor ay lumilitaw bilang isang nakikitang prompt sa muling pagkonekta — hindi kailanman bilang mga sirang tampok nang tahimik. Gumagana ang pagbawi mula sa alinmang panig: idiskonekta dito, o bawiin sa sariling mga setting ng seguridad ng vendor.

A2Isulat ang semantics at daloy ng data

Ang bawat paggalaw ng data ay isang tahasang aksyon na may na-log na resulta. Ang mga pagsulat ay nangyayari sa iyong pag-click — o awtomatiko lamang kung saan ka nag-enable ng panuntunan (ang auto-push sa hire ay off bilang default, bawat provider). Ang mga pagbabasa — pag-import ng mga tao, account, o file — ay tumatakbo kapag pinindot mo ang Import, dinu-duplicate laban sa kung ano na ang mayroon ka (mga kliyente ayon sa pangalan, mga tao ayon sa email), nilaktawan sa halip na i-overwrite, at tapat na nag-uulat ng nalikha kumpara sa nilaktawan, kaya naman ang muling pagpapatakbo ng anumang pag-import ay ligtas ayon sa disenyo.

Ang bawat aksyon ay nagsusulat ng isang hilera sa app-activity journal (ats_app_activity): kung ano ang tumakbo, kailan, para sa aling rekord, at ang kinalabasan — kabilang ang sariling teksto ng error ng vendor nang verbatim kapag may nabigo. Ang pag-uulat ng paggamit sa loob ng ATS ay pinagsasama-sama ang parehong journal na iyon, kaya ang pag-uulat ng integrasyon at ang katotohanan ng integrasyon ay hindi maaaring maghiwalay.

Anumang bagay na lumalabas sa kahilingan sa landas — notification fan-out, paghahatid ng webhook, activity journalling, mail — ay tumatakbo sa mga background thread na fire-and-forget. Ang isang mabagal na panlabas na endpoint ay hindi kailanman magiging dahilan upang mag-hang ang interface, at ang isang nabigong side effect ay na-log sa halip na tahimik na subukang muli hanggang sa maging hindi konektado.

A3Mga pagsasaalang-alang sa pagpapatakbo

Ang mga koneksyon ay nasa antas ng organisasyon at naka-gate sa mga tungkulin ng may-ari at admin; ginagamit ng mga recruiter ang mga tampok na pinapagana ng isang koneksyon ngunit hindi maaaring kumonekta, mag-disconnect, o muling i-configure. Ang pag-disconnect ay tinatanggal kaagad ang mga naka-store na kredensyal at pinatitigil ang mga umaasang tampok nang nakikita, hindi tahimik. Ang data na na-import na ay nananatiling sa iyo at puwedeng i-edit.

Ang mga na-import na tao ay dumarating na minarkahan bilang na-import na may mga konserbatibong default sa privacy — walang pahintulot ang ipinapalagay para sa sinumang hindi kailanman nagpunan ng iyong form ng aplikasyon, at nalalapat ang mga default sa pagpapanatili. Ang lahat ng isinulat ay sa iyo upang kunin: ang mga pag-export ng CSV at ang Data Export app ay sumasaklaw sa parehong mga tindahan na binabasa ng produkto mismo. Ang exit ay kasingbukas ng pasukan — sa disenyo, hindi konsesyon.

A4Paglalagay sa topolohiya ng integrasyon

Ang integrasyong ito ay live na ngayon sa registry. One connection per provider unlocks every feature it powers, and the topology grid below shows the neighbouring connectors in the same capability area — statuses come from the same registry that drives the in-app hub, so this page can never claim more than the product does. For anything the catalogue does not cover, Webhooks and Zapier are the generic, documented escape hatch.