Skip to content
Guide for writing hero card connectors
Branch: master
Clone or download
rworsnop Merge pull request #30 from RyanBard/APF-2362_add_localized_label_and…

APF-2362: Add localized label and validator descriptions
Latest commit 3002df4 Jul 8, 2019

Mobile Flows Connectors Guide


This serves as a guide for writing connectors for the Mobile Flows. A connector is an adapter with two responsibilities:

  • Based on object requests, render objects. This would typically be achieved by accessing an external backend system. The object is a JSON structure that allows a client to display something meaningful to the user. The object also includes references to actions the user can take, relevant to the context of the object. Note that the Weather connector in the samples section uses Card, a type of oject as defined here :
  • Provide endpoints for all actions advertised in the object.

All communication with a connector is over HTTPS. A connector can be written in any language that allows the developer to create HTTP endpoints.


The Weather Connector accesses a fictitious crowd-sourced weather service to produce a card showing a requested ZIP code's weather. It also includes an action to report the actual current temperature for that ZIP.

A client requests a weather card and the following request is forwarded to the connector:

$ curl -H "Authorization: Bearer abcdef" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "X-Routing-Prefix: /connectors/weather/" \
-X POST -d '{"tokens":{"zip":["30360"]}}' \

The card includes current weather conditions for ZIP code 30360, as well as an action to report the current temperature. If the user chooses that action, the following request will be forwarded to the connector:

$ curl -H "Authorization: Bearer abcdef" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json" \
-X POST -d "zip=30360&temperature=78" \

A stubbed service based on the above can be found in the samples section of this project.

Further reading

For a detailed specification, please see the wiki.

You can’t perform that action at this time.