An API property ends up in the API docs, a property only ends up in the developer docs.
API properties are what people normally configure and which stay the same during multiple versions of OL.