API

Lähetä verkkosivuston lomake SoftReplyyn ja tallenna tiekarttapyyntö omasta järjestelmästäsi.

SoftReplylla on kaksi ovea omille järjestelmillesi. Kumpikin vastaa tavallisilla HTTP-tilakoodeilla, eikä kumpikaan vaadi SoftReply-kirjautumista.

Lomake verkkosivustollasi

Lomakkeet on moduuli. Avaa Lomakkeet, valitse lomake ja avaa sen verkkosivuston ovi. Lisää sivustosi osoite lomakkeen sallittuihin alkuperiin. Sivusi lähettää sitten keräämänsä tiedot JSON-muodossa lomakkeen omaan osoitteeseen:

curl -X POST https://app.softreply.com/api/forms/YOUR-FORM-KEY \
  -H "Content-Type: application/json" \
  -H "Origin: https://www.yourcompany.com" \
  -d '{"email": "kari@example.com", "name": "Kari Nordmann", "message": "…"}'

Se vastaa 202:lla ja uuden vastaanoton id:llä, kun lomake hyväksyy sen, 422:lla ja virheillä jokaiselle kentälle, kun se ei hyväksy, 404:llä, kun avain tai alkuperä ei ole SoftReplylle tuttu, ja 503:lla, kun lomakkeen takana oleva vastaanotin ei vastannut. Lomakesivu näyttää tarkan sisällön lomakkeesi kentille.

Roadmap-pyyntö palvelimeltasi

Avaa Asetukset ja sitten Roadmap nähdäksesi työtilasi salaisuuden. Palvelimesi lähettää sen otsikossa:

curl -X POST https://app.softreply.com/board/YOUR-BOARD-TOKEN/request \
  -H "X-Workspace-Secret: YOUR-WORKSPACE-SECRET" \
  -d email=person@example.com -d one_line="What they asked for" -d why="Their words"

Pidä työtilan salaisuus palvelimellasi. Sitä ei koskaan laiteta verkkosivulle.