APIs are contracts. They outlive the code that implements them, so designing them well pays off for years.
Versioning
Prefer additive changes. Never break an existing field without a new version.
Validation
Validate at the edges and fail loudly. Silent coercion is a future bug.