added api troubleshooting section

@miketheman - we discussed adding this info in somewhere, so i created this section.