API:et

Skicka ett webbplatsformulär till SoftReply och skicka in en färdplansbegäran från ditt eget system.

SoftReply har två dörrar för dina egna system. Vardera svarar med vanliga HTTP-statuskoder, och ingen behöver en SoftReply-inloggning.

Ett formulär på din webbplats

Formulär är en modul. Öppna Formulär, välj formuläret och öppna dess webbplatsdörr. Lägg till din webbplats adress till formulärets tillåtna ursprung. Din sida skickar sedan det den samlat in som JSON till formulärets egen adress:

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 svarar 202 med den nya intakets id när formuläret accepterar det, 422 med felen för varje fält när det inte gör det, 404 när nyckeln eller ursprunget inte är ett som SoftReply känner till, och 503 när en mottagare bakom formuläret inte svarade. Formulärsidan visar den exakta kroppen för ditt formulärs fält.

En färdplansförfrågan från din server

Öppna Inställningar, sedan Färdplan, för att se din arbetsytas hemlighet. Din server skickar 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"

Behåll arbetsytans hemlighet på din server. Den läggs aldrig in på en webbsida.