Versions Compared

Old Version 5

changes.mady.by.user Stanislav Slacky

Saved on

compared with

New Version Current

changes.mady.by.user Noema Bradnanska

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

Comment Service

...

A particular comment belonging to an issue can be modified using the comment service.

...

Deck of Cards
idbimGetComment


Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: comments/<comment_id> 

URL: https://api-stage.bimplus.net/v2/<team_slug>/comments/<comment_id>

Example:https://api-stage.bimplus.net/v2/bimplus/comments/db540336-47a3-426e-b3bf-1e532bfac8ea 


Card
labelHTTP Method
 GET


Card
labelDescription
 Get details of a specified comment.


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSON
{
	"id": "db540336-47a3-426e-b3bf-1e532bfac8ea",
    "issueId": "8415bd8d-7e27-4975-bddb-b1b365719770",
    "text": "Second Comment: The fire exit should be x:120, y: 120; z: 340",
    "createdAt": "2013-11-20T08:17:36+00:00",
    "modifiedAt": "2013-11-20T08:17:36+00:00",
    "author": {
        "id": "132a78a5-b523-4bf2-8382-7098fac3f803",
        "email": "test@bimplus.net",
        "status": "Active",
        "firstname": null,
        "lastname": null,
        "company": null,
        "displaynamefullname": null"test test",
        "infodisplayname": null "test test [test test]",
        "gendershortdisplayname": null,"test test"
        },
	"phoneWorkstatus": null,
        "phoneHomeverbalStatus": null,
    "hyperlinks": [
		{
			"id": "6943aa22-36d4-4f9d-883b-e829838d7fbc",
			"objectId": "6c4c82eb-92f4-40ff-9e49-98d565cdf35b",
			"orderNumber": "fax1,
			"name": null"1",
			"url": "bimplus.com"
		},
		],
	 "attachmentLinks": [
     "mobile": null,
       {
                "birthDateid": null,
"c77b3e31-73f6-498a-9b40-f63f894c0477",
                "addressobjectIds": {[
            "street": "",        "06af7c41-fa41-4682-b337-7bd6af6a090d"
            "streetNr": ""    ],
                "zipname": "ifc01-1",
                "cityfileName": "ifc01-1.ifc",
                "countrytype": "application/octet-stream",
        },
        "preferedLanguagesize": null
4522,
            },
    "idcreatedAt": "db5403362021-47a3-426e-b3bf-1e532bfac8ea"
}

...

Update the comment
Deck of Cards
idbimCommentUpdate
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: comments/<comment_id> 

URL: https://api-stage.bimplus.net/v2/<team_slug>/comments/<comment_id>

Example: https://api-stage.bimplus.net/v2/bimplus/comments/db540336-47a3-426e-b3bf-1e532bfac8ea

JSON Structure:

Name

Mandatory / Optional

Type

Description

issueIdwill be ignoredstring(guid)The id of the issue

text

mandatory

string

The comment text

createdAt

will be ignored

string (date)

Creation date of the comment

modifiedAtwill be ignoredstring (date)Modified date of the comment

author

optional

object

The author of the comment

Card
labelHTTP Method
 PUT
Card
labelDescription
Update the specified comment.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
langxml
titleJSON
{
    "issueId": "8415bd8d-7e27-4975-bddb-b1b36571977002-17T10:37:01.7966667",
                "creator": {
                    "id": "04002d23-8d64-1016-9f82-95ad8f2398b3",
    "text": "Second Comment: The fire exit should be x:120, y: 120; z: 340",
    "createdAtemail": "2013-11-20T08:17:36+00:00test@allplan.com",
                    "modifiedAtstatus": "2013-11-20T08:17:36+00:00Active",
    "author": {
                "idfirstname": "132a78a5-b523-4bf2-8382-7098fac3f803"test",
    }
}
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK
Code Block
titleJSON
{
                "issueIdlastname": "8415bd8d-7e27-4975-bddb-b1b365719770test",
    "text": "Second Comment: The fire exit should be x:120, y: 120; z: 340",
    "createdAtcompany": "2013-11-20T08:17:36+00:00test test",
        "modifiedAt            "fullname": "2013-11-20T08:17:36+00:00test test",
        "author": {
            "iddisplayname": "132a78a5-b523-4bf2-8382-7098fac3f803test test [test test]",
        "email            "shortdisplayname": "test@bimplus.net",
test test"
                },
                "statuschanged": "Active2021-02-17T10:37:02.28",
                "firstnamechangedBy": null,{
           "lastname": null,
        "companyid": null"04002d23-8d64-1016-9f82-95ad8f2398b3",
        "displayname": null,
            "infoemail": null"test@allplan.com",
           "gender": null,
        "phoneWorkfirstname": null"test",
           "phoneHome": null,
        "faxlastname": null,"test"
        "mobile": null        },
        "birthDate": null,
        "addressattachmentType": {"Document",
                "streetsizeMB": "0",
                "streetNrversion": ""1,
                "ziprelatedId": "06af7c41-fa41-4682-b337-7bd6af6a090d",
                "cityrelease": ""true,
                "countryreleaseVersion": ""
[
               },
     1
             "preferedLanguage": null   ]
    },        }
    "id": "db540336-47a3-426e-b3bf-1e532bfac8ea"
}

...

Delete the comment
Resource: comments/<comment_id> 

URL: https://api-stage.bimplus.net/v2/<team_slug>/comments/<comment_id>

Example: https://api-stage.bimplus.net/v2/bimplus/comments/8836308d-f09f-4bb7-b6d2-354a2db205a6

Deck of Cards
idbimDeleteComment
Card
defaulttrue
labelURL / Resource / JSON Structure
Card
labelHTTP Method
 DELETE
Card
labelDescription
 Deletes a specified comment.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK
 ]	  
}