6 things non-Tech people always ask API developers

Julie Lambert
Apr 4, 2019 · 3 min read
Image for post
Image for post

If, like me, you’re a “non-developer” navigating in a team of developers, you may put your foot in it sometimes, even if you’re full of good intentions. But, there are ways of avoiding common mistakes if you want to pull off a decent conversation with an API developer. Here’s how.

I quickly learned that this question literally makes no sense. It’s like asking a mechanic what kind of spare parts he needs to fix a car. He’ll tell you that it depends on what’s wrong with the vehicle. The same goes for development languages. Some are meant to build dynamic pages, some are made to integrate systems more effectively and others are object-oriented. It’s not about finding the “best language” but using the “right language” to achieve their goals.

Once again, it’s like being asked to choose between a car and a plane… it depends on the trip you’re planning. Dailymotion’s public API is a REST API meant to allow people to create great video applications. We also use a GraphQL API internally to organize our new global architecture. REST is a standard that a lot of developers use when GraphQL is more complex. It is also more flexible and efficient. In short, it’s not profitable to use a plane to travel 5 km (the plane would be GraphQL here), but it’s not like you can fly with your car (REST here).

I first asked this question because I saw this cartoon and didn’t get the joke.

Image for post
Image for post
Funny… or is it?

Turns out, a REST-compatible API, or “RESTful API”, is an application programming interface that uses HTTP requests to obtain (GET), place (PUT), publish (POST) and delete (DELETE) data. This kind of API gives developers flexibility, but it can also be a challenge when it comes to starting from scratch. Now you understand that asking a developer if his API is RESTful is like asking him if his API is an API by the book.

For some strange reason, the word “microservice” has the power to cause mischief in the developer community. No one seems to be 100% sure about what a microservice is or isn’t, but what developers do know is that APIs are not microservices. Although the two notions are quite close, APIs are data recipes supposed to specify interactions between different software components, while microservices have a more architectural approach and help developers create and scale services. I know, it’s subtle.

Like many non-developers, I thought coding was about maths. Because of this preconception, a lot of people lose interest in development languages. You don’t have to be a mathematician to be a good developer (although being logical is crucial), what you really need is curiosity and the ability to learn new syntaxes. I also used to think that developers had to remember all the formulas for each language, when in fact, there are a huge amount of communities dedicated to specific languages or disciplines. Finding and joining them gives you access to lots of code examples and software tools. So really, a developer is more like an anthropologist using foreign languages to communicate with the world than a a genius mathematician.

Unfortunately, I don’t have the answer to this question, my colleagues’ choice of clothing remains a mystery to me…

Image for post
Image for post
Developers work in mysterious ways


The home for videos that matter

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store