API-et

Send et nettstedsskjema inn i SoftReply, og registrer en veikartforespørsel fra ditt eget system.

SoftReply har to dører for dine egne systemer. Hver svarer med vanlige HTTP-statuskoder, og ingen trenger en SoftReply-pålogging.

Et skjema på nettsiden din

Skjemaer er en modul. Åpne Skjemaer, velg skjemaet, og åpne nettstedsdøren. Legg til nettstedets adresse i skjemaets tillatte opprinnelser. Siden din sender så det den samlet inn som JSON til skjemaets egen adresse:

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": "…"}'

Den svarer 202 med den nye henvendelsens id når skjemaet godtar den, 422 med feilene for hvert felt når den ikke gjør det, 404 når nøkkelen eller opprinnelsen ikke er en SoftReply kjenner, og 503 når en mottaker bak skjemaet ikke svarte. Skjemaets side viser den eksakte kroppen for skjemaets felter.

En veikartforespørsel fra serveren din

Åpne Innstillinger, deretter Veikart, for å se arbeidsområdets hemmelighet. Serveren din sender den i en header:

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"

Hold arbeidsområdets hemmelighet på serveren din. Den blir aldri lagt i en nettside.