What makes a cellular IoT API great?
Tobias Goebel, Principal Product Marketing Manager, IoT, Twilio
Why IoT SIMs need an API in the first place
The core functions needed in a cellular IoT API: SIM activation and deactivation, SIM status queries, Network access configuration, Pulling billing information and usage records, Troubleshooting, Device reachability
What matters in a good API (any API)
10 tips and tricks for how to find a good IoT SIM with a strong API
Transcript: #StandardsGoals for 2024: What’s new for BISAC - Tech Forum 2024
What makes a cellular IoT API great? Tobias Goebel
1. What makes a
cellular IoT API
great?
Tobias Goebel
Principal Product Marketing Manager, Twilio IoT
@tpgoebel
linkedin.com/in/tpgoebel
2. 1 Key SIM management functions that need APIs
2 How cellular IoT APIs support your business objectives
3 Characteristics of a great API – and how to find one
(with 15 tips & tricks what to look out for in a vendor API)
2022 TWILIO INC. ALL RIGHTS RESERVED
What I’ll cover today
4. 3 ways to manage SIMs
2022 TWILIO INC. ALL RIGHTS RESERVED
Web
Console
Customer
Support
Your Workflows
(via APIs)
5. 2022 TWILIO INC. ALL RIGHTS RESERVED
The best SIM management solution makes
managing 50,000 SIMs as easy and
efficient as managing 50
6. 2022 TWILIO INC. ALL RIGHTS RESERVED
SIM status queries
Network access configuration
SIM activation and deactivation
Which SIM management functions
APIs can help with
Troubleshooting
Device reachability
Billing information and usage records
7. How cellular IoT APIs support your
business objectives
2022 TWILIO INC. ALL RIGHTS RESERVED
Enable scalability to
support growth and
expansion
Provide better
troubleshooting
Allow more
customization to align
with the business
Simplify operations
and reduce operating
expenses
8. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Well documented
and easy to use
– and how to find one
Code examples, tutorials, use cases
Jargon-free
Well maintained; like a product in itself
9. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Well documented
and easy to use
– and how to find one
Check whether a recently announced feature has been documented
yet. If the documentation is rolled out together with the public
feature announcement, that’s an indication that the product
manager themself may have written it, which is a good sign.
Tip 1
10. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Well documented
and easy to use
– and how to find one
Do a web search for a feature to see whether the API
documentation is on the first page of results. If it is, that tells you it’s
a page that developers actively use and that it’s relevant enough for
the search engine to highlight.
Tip 2
11. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Well documented
and easy to use
– and how to find one
Ask your vendor for a sample bill and a sample log file. Can you
understand them? Can you easily translate them into useful
information?
Tip 3
12. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Well documented
and easy to use
– and how to find one
Put the URL of a documentation page into archive.org to see what
has changed in the last year or two. Have they added examples,
fixed errors, or given more detailed explanations?
Tip 4
13. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Backward compatible
– and how to find one
A good API has few to no breaking changes
Devices will live for years in the field
14. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Backward compatible
– and how to find one
Look at the API versioning. An API with many versions that are no
longer supported — and with no history of when support ended —
is likely more volatile.
Tip 5
15. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Backward compatible
– and how to find one
Search for blog posts or news items about
breaking changes for that API.
Tip 6
16. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Reliable and highly available
under stress
– and how to find one
An API shouldn’t have downtime
API behavior during your testing != API
behavior in production
17. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Reliable and highly available
under stress
– and how to find one
Check for service level agreements (SLAs) that guarantee uptime
and performance of the APIs themselves.
Tip 7
18. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Reliable and highly available
under stress
– and how to find one
Find out if there are maintenance windows. Can you do a SIM
activation API call during that time? What could cause your
usage reporting to be delayed? How often do maintenance
windows occur, and how long do they last? Ask questions and
get the answers in writing.
Tip 8
19. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Reliable and highly available
under stress
– and how to find one
Search for a vendor status page (often status.companyname.com).
Is there a developer portal or public listing of metrics related to
outages and uptime? Have they had recent big outages? Do they
provide root cause analysis or publish reasons for outages (RFOs)?
When something goes wrong, you’re looking for an honest detailed
explanation that assures you things will improve.
Tip 9
20. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Reliable and highly available
under stress
– and how to find one
Get the vendor’s request limits. How many API requests can you
make per second? Or how many concurrent API requests can you
make? If they don’t know, that tells you a lot about the quality of the
API.
Tip 10
21. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Attracts an active developer
community
– and how to find one
Open-source repositories
Active forums, current blog posts
Helper libraries you can import
22. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Attracts an active developer
community
– and how to find one
Ask your developers if they’ve ever heard of the vendor you’re
evaluating. The answer will tell you how developer-friendly and
developer-focused they are.
Tip 11
23. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Attracts an active developer
community
– and how to find one
Research vendor communications with the developer community.
Does the vendor send regular updates? Can you subscribe to a
product newsletter? Do they run regular webinars on new features?
What’s the cadence of product announcements? Do they maintain a
public change log? What documentation do they deliver on release
day to encourage people to build?
Tip 12
24. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Well supported
– and how to find one
Doesn’t send you to Sales for questions
Supports developers like they were
paying customers
25. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Well supported
– and how to find one
Look at the support plans. Is “Developer” mentioned as a category?
What support does it include?
Tip 13
26. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Well supported
– and how to find one
Find out which support channels are offered for free. Is it just email,
or can you use chat or even voice channels?
Tip 14
27. 2022 TWILIO INC. ALL RIGHTS RESERVED
Characteristics of a great API
Well supported
– and how to find one
Find out which support channels are offered for free. Is it just email,
or can you use chat or even voice channels?
Tip 15
29. Twilio Super SIM
Maximum global coverage
on one SIM
Stop managing carriers
Access hundreds of 2G, 3G,
LTE, and IoT networks from
top tier carriers – all via
one multi-IMSI SIM
Choice of networks, with
built-in redundancy
Get reliable service
Select and control which
carriers each of your devices
connect to, with automatic
failover if needed
Efficient operations on a
global IoT-only network
Reduce connectivity TCO
Manage your entire fleet
centrally with APIs & console,
and benefit from constant
platform improvements
Free expert advice and
self-help resources
Accelerate time to value
Prototype and go to production
quickly with free trial, free
resources and free expert
advisory – all pre-contract
No shenanigans
pricing and fulfilment
Predict your costs accurately
Get your SIM orders fulfilled fast
and control your cellular costs with
upfront discounts and never pay
for overages or unused data
30. 2022 TWILIO INC. ALL RIGHTS RESERVED
Read more about
SIM APIs?
twil.io/SIMAPI