Our SAAS integrates with a lot of 3rd party api’s. It’s great when you write an integration in an afternoon, and able to say, “That was easy”. But when you spend 3 weeks to add a little data lookup I hate your API, and by extension you.
Your HTTP API Returns 200 on Error
Ok I get it, not ever HTTP api in the world is RestFul. But we I write nine API integrations and all of them return http header codes that match the response, I am going to hate you for being different.
You Return “OK” On an Empty Post/Put Request
Really this is my fault because a bug in my code sent you an empty request. But for the love of god, help your fellow coder out, and let me know. Assume that if I am hitting your API I want you do something, so if you do nothing, please let me know.
You Converted your XML API to JSON (But not really)
You provided a data service, and its was great. People loved you and needed you. Life was good. You send your data as XML, no shame in that. But one day all of the cool kids switched to JSON to send data whizzing around the world. You want in. So you hit StackOverflow and do this:
$xml = simplexml_load_string($xml_string);
$json = json_encode($xml);
$array = json_decode($json,TRUE);
Boom you are done. Reliving your glory days. But not really, XML isn’t the same as JSON. And now my data is full of “@attribute”. Oh, and now I hate you.