I learned twenty painful API lessons this year. Some are embarrassing, some are just weird. I wrote them down because I do not want to repeat them. If this is interesting, I will answer questions.