whoami

Victor Bjelkholm

Developer Evangelist at Typeform

victor@typeform.com

@VictorBjelkholm

Goal

Full understanding of the creation of the API and handling results

What we will learn

• What tools are the best and only tools for dealing with APIs (may contain personal preferences)
• How to get an API-key
• How to find the information you’ll need
• How to create a typeform
• How to use the webhooks for some live action
• Where and how to get help if you have problems

Installation

Installing the tools we will need

Tools

Postman

https://chrome.google.com/webstore/detail/postman-rest-client-packa/fhbjgbiflinjbdggehcddcbncdddomop 

Ngrok

https://ngrok.com/download

Node.js

https://nodejs.org/download/

In the meantime

Lets get familiar with the homepage

Landing

Documentation

Sandbox

Questions & Answers

Changelog

#Slack Community

#Slack Community

Signup

Demo time!

You should have a API-key by now

Shout if you don't!

Endpoint

https://api.typeform.io/v0.2/forms

{
  "title": "New Form",
  "fields": [
    {
      "type": "yes_no",
      "question": "Are you feeling fine?",
      "description": "We just want to know how you feel"
    }
  ]
}

Typeform JSON

{
  "id": "pQL-1ddmi1u76A",
  "design_id": 1,
  "fields": [
    {
      "type": "yes_no",
      "question": "Are you feeling fine?",
      "position": 0,
      "choices": null,
      "id": 221126
    }
  ],
  "links": {
    "form_render": {
      "get": "https://forms.typeform.io/to/pQL-1ddmi1u76A"
    }
  },
  "title": "New Form",
  "webhook_submit_url": null
}

Response

Live reports!

Installing the project "SimpleLiveReports"

git clone https://github.com/TypeformIO/SimpleLiveReports.git

cd SimpleLiveReports

npm install

node index.js

Run ngrok

./ngrok 5000


# OUTPUT

Tunnel Status                 online
Version                       1.7/1.7
Forwarding                    http://37e80c7f.ngrok.com -> 127.0.0.1:5000
Forwarding                    https://37e80c7f.ngrok.com -> 127.0.0.1:5000
Web Interface                 127.0.0.1:4040
# Conn                        62
Avg Conn Time                 1.94ms

Your Webhook URL:

http://37e80c7f.ngrok.com

Copy Webhook URL into .env

FORM_TITLE=SimpleLiveReports
API_ENDPOINT=https://api.typeform.io/v0.2/forms
API_TOKEN=your_apikey

LIVE_DOMAIN=http://37e80c7f.ngrok.com

FORM_WEBHOOK and API_TOKEN both needs to be modified

LIVE_DOMAIN=http://37e80c7f.ngrok.com

Hit /create_form endpoint

Navigate to report

links.results_report.get  link helps you with that!

Submit answers

should work, please don't hate me if it doesn't!