Fix: Add missing Swagger annotations for identity path parameters

[Deekshit014]

Proposed changes

Please include a summary of the changes here and why we need those changes. And also let us know which issue is fixed.

This PR resolves Issue #1528, where the embedded Swagger UI failed to correctly prompt for and substitute the identity ID (iid) in the path for GET /identities/{iid} and PATCH /identities/{iid} API calls.

The issue was caused by missing Go Swagger annotations (@Param) above the relevant route handler declarations.

The fix involves adding the necessary annotations to ensure the Swagger documentation generator correctly maps the path variable to a user input field, allowing the API calls to execute properly from the UI.

Fixes #1528

---

Types of changes

• Bug fix
• New feature added
• Documentation Update

---

Please make sure to follow these points

• I have read the contributing guidelines.
• I have performed a self-review of my own code or work.
• I have commented my code, particularly in hard-to-understand areas.
• My changes generates no new warnings.
• I have added tests that prove my fix is effective or that my feature works.
• My changes have sufficient code coverage (unit, integration, e2e tests).

---

Screenshots (If Applicable)

---

Other Information

The Swagger annotations were added to the route_get_identity_by_id.go and route_patch_update_identity.go files, and the documentation was regenerated using the swag tool.

I have verified the fix locally by running the FireFly stack and testing both the GET and PATCH identity endpoints in the Swagger UI.