API'en

Send en hjemmesideformular til SoftReply, og indsend en roadmap-anmodning fra dit eget system.

SoftReply har to døre til dine egne systemer. Hver svarer med almindelige HTTP-statuskoder, og ingen kræver et SoftReply-login.

En formular på din hjemmeside

Formularer er et modul. Åbn Formularer, vælg formularen og åbn dens hjemmesidedør. Tilføj din sides adresse til formularens tilladte oprindelser. Din side sender så det indsamlede som JSON til formularens 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 henvendelses id, når formularen accepterer den, 422 med fejlene for hvert felt, når den ikke gør, 404 når nøglen eller oprindelsen ikke er en, SoftReply kender, og 503 når en modtager bag formularen ikke svarede. Formularsiden viser den nøjagtige body for din formulars felter.

En roadmap-anmodning fra din server

Åbn Indstillinger og derefter Roadmap for at se din workspace-hemmelighed. Din server 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"

Behold workspace-hemmeligheden på din server. Den må aldrig sættes ind på en webside.