docs: update mtam with clarifications

[SondreJDigdir]

Description

update mtam with clarifications

Documentation

• Doc updated

Summary by CodeRabbit

• Documentation
  • Added clearer introductory descriptions for list, fetch-by-ID, and submit endpoints to clarify who calls them and when
  • Clarified acknowledgment behavior and retry handling, with note repositioned for visibility
  • Expanded FAQ with guidance on handling incoming messages, whether to send to the service, and retrospective/timing support
  • Minor wording edits for consistency and operational clarity

[coderabbitai]

Walkthrough

Clarified MTAM API docs: added brief intros for GET (list and by ID) and POST endpoints, restated confirmation/retry behavior, and expanded the Q&A with guidance on handling incoming messages, timing/retrospective fetches, and retry semantics.

Changes

Cohort / File(s)	Summary
API documentation content/tjenester/tilsynsdata/datakilder/mtam/_index.md	Added introductory descriptions for GET list and GET by ID endpoints; added context for POST (Tilda-delivered messages and source pointing to a Tilda URL); repositioned and retained note on confirmations (200 OK with empty body; non-2xx triggers retries); expanded Q&A to clarify optionality of sending/receiving and handling of incoming messages, plus timing/retrospective fetch guidance.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: documentation updates to MTAM with clarifications added to explain endpoint behavior and handling.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch docs/clarifications-mtam

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}