Rest/Api v9.14/v3: "/api/admin/users" missing "_links" section per item

Stefan Hall shared this problem 2 months ago
Defect Logged

Hi,

new version, new bugs, unfortunately.
In the API v3 you have adjusted the response payload and forgotten the “_links” area per item. It is specified in the documentation and all previous API versions also have this entry per item

A serious mistake for us, because our HR integration needs this link to be able to maintain user data. Please make improvements very quickly and provide a HF

DOKU https://developers.yellowfinbi.com/dev/api-docs/v3.0/#operation/getUsersAdmin

;) Stefan


a2f2c87a44253ae12ef387716c07c316

Replies (2)

photo
1

Hi Stefan,

And a very good morning to you!

Let me just have a look into this and verify in 9.14. If it's the case here too, we can get a bug report written and a fix in place.

Kind regards,

Chris

photo
1

Hi Stefan,

Just to confirm, I received the following response in the API v2 on 9.13:

{
    "items": [
        {
            "ipId": 5,
            "lastName": "Administrator",
            "firstName": "System",
            "initial": "",
            "userId": "admin@yellowfin.com.au",
            "roleCode": "YFADMIN",
            "status": "ACTIVE",
            "_links": {
                "self": {
                    "href": "/api/admin/users/5",
                    "options": [
                        "GET",
                        "PATCH"
                    ]
                },
                "password": {
                    "href": "/api/admin/users/5/password",
                    "options": [
                        "PUT"
                    ]
                },
                "resetPassword": {
                    "href": "/api/rpc/admin/users/5/reset-password",
                    "options": [
                        "POST"
                    ]
                },
                "userSessions": {
                    "href": "/api/admin/users/5/sessions",
                    "options": [
                        "DELETE"
                    ]
                },
                "orgAccess": {
                    "href": "/api/admin/users/5/org-access",
                    "options": [
                        "GET",
                        "POST"
                    ]
                }
            }
        }
And the response below in 9.14 with the v3 API call:

{
    "items": [
        {
            "userPreferences": {
                "draftContentItemCount": 5,
                "retainContentTypeFilterOnBrowsePage": false
            },
            "userId": 5,
            "lastName": "Administrator",
            "firstName": "System",
            "preferredLanguageCode": "EN",
            "email": "admin@yellowfin.com.au",
            "userName": "admin@yellowfin.com.au",
            "roleCode": "YFADMIN",
            "timeZoneCode": "AUSTRALIA/SYDNEY",
            "status": "ACTIVE"
        }
    ],
    "_links": {
        "menu": {
            "href": "/api/menus/mobile-menu",
            "options": [
                "GET"
            ]
        },
        "api": {
            "href": "/api",
            "options": [
                "GET"
            ]
        },
        "self": {
            "href": "/api/admin/users",
            "options": [
                "GET",
                "POST"
            ]
        }
    }
}
Which is clearly missing the _links items. I'll get a bug report written up for the developers and request a high priority.

Do you have any further questions on this topic?

Kind regards,

Chris

photo
1

Hello Chris,

I'm glad you asked. How long do I have to wait for the fix ;)

;) Stefan

photo
1

Hi Stefan,

Haha, I can tell you it's coming Soon™

Really though, there's a couple of items that have come up already, we'll probably see something early in the New Year.

I'll move this over to Defect Logged while we wait for the fix.

Kind regards,

Chris

photo
1

Hi Chris,

the hotfix has been released, but this bug is still not fixed. This is a bit annoying, especially as I had already reported the error on the release day and there was also a fix for the API.

Do I have to wait another month now, if there will be another hotfix at all? Otherwise I'll wait at least another 2 months

;) Stefan

photo
1

Hi Stefan,

You should be able to use the old V2 API call for this by changing the content type to api-v2 to get the _links. Can you let me know if that works for you?

Kind regards,

Chris

photo
1

Hi Chris,

not distract you;)

You had promised a hotfix with the next release/patch. The patch is there, the hotfix is not.
Of course the old API works, BUT I can't use a different API for every call and v3 now includes features we've been waiting for.

;) Stefan

photo
1

Hi Stefan,

I believe I said it was coming soon, however as we have a workaround this was not included in the hotfix. I did not promise it was coming.

Let me know if there's something specific in the v3 version of this /api/users/admin endpoint and I'll use that as leverage to raise the priority.

Kind regards,

Chris

photo
Leave a Comment
 
Attach a file