One I see a lot is not being careful to use the correct error type / status code. E.g. if you're in python and raise a value error when an API is rate limited,

One I see a lot is not being careful to use the correct error type / status code. E.g. if you're in python and raise a value error when an API is rate limited, someone down stream from you is going to have a bad time.