[7] docs: add integration safety guide

[romanindev]

Add documentation explaining:

• response validation
• idempotency
• retry safety
• best practices

Acceptance criteria

• code examples
• explanation of "why it matters"