Récupération des commentaires

Un utilisateur a la possibilité de publier un commentaire sur une intervention.
 ⁠⁠Commentaire sur une opération⁠ 

Récupération des informations

En tant que prestataire, je récupère les nouveaux tickets et ceux qui ont été récemment mis à jour via une requête GET sur l'API Operations v2.
/api/operations/v2/operations?since=2021-06-01T10:00:00&notIssuedByMe=true&fields=logs

Un commentaire sur une intervention se matérialise par la transmission d'un log status=open/pending/hold et event=commented. Pour identifier cette information, je regarde la rubrique logs du json récupéré.

L'état de l'intervention n'est pas modifié mais un log supplémentaire est disponible, commented. Je peux récupérer de plus amples informations sur le log de commentaire (event=commented) dans la rubrique logs.

Exemple

{
    "_links": {
        "self": {
            "href": "https://api.hubintent.com/api/operations/v2/operations?notIssuedByMe=true&fields=logs&type=intervention&since=2024-02-29T10:50:00"
        }
    },
    "_embedded": {
        "operations": [
            {
                "reference": "INTER-05062024-4",
                "issuer": {
                    "entity": {
                        "id": "5853fdefc2829a04502a073a",
                        "label": "Intent Technologies Tests Internes",
                        "logoUrl": "https://hubintent.com/intent/entities/logos/c74fd223-bc40-46c2-bf42-6748a9cfe146"
                    },
                    "user": {
                        "id": "035aa297-15fe-4cad-8ba3-16451af564d8",
                        "type": "client",
                        "name": "tests api internes"
                    }
                },
                "contract": {
                    "reference": "contractMultiservices",
                    "label": "Multiservices",
                    "topic": "Multiservices",
                    "entities": [
                        {
                            "id": "5853fdefc2829a04502a0734",
                            "label": "Intent Staff",
                            "logoUrl": "https://hubintent.com/intent/entities/logos/fdaf450a-4ae4-4c2b-93cb-5338bd286219"
                        },
                        {
                            "id": "5853fdefc2829a04502a073a",
                            "label": "Intent Technologies Tests Internes",
                            "logoUrl": "https://hubintent.com/intent/entities/logos/c74fd223-bc40-46c2-bf42-6748a9cfe146"
                        }
                    ]
                },
                "service": {
                    "code": "P902",
                    "originalCode": "P902"
                },
                "status": "open",
                "event": "acknowledged",
                "eventDate": "2024-02-17T16:02:00+01:00",
                "logDate": "2024-02-17T16:02:00+01:00",
                "eventHistory": [
                    "requested",
                    "acknowledged",
                    "commented"
                ],
                "logs": [
                    {
                        "issuer": {
                            "entity": {
                                "id": "5853fdefc2829a04502a073a",
                                "label": "Intent Technologies Tests Internes",
                                "logoUrl": "https://hubintent.com/intent/entities/logos/c74fd223-bc40-46c2-bf42-6748a9cfe146"
                            },
                            "user": {
                                "id": "035aa297-15fe-4cad-8ba3-16451af564d8",
                                "type": "client",
                                "name": "tests api internes"
                            }
                        },
                        "reference": "INTER-05062024-4",
                        "description": "La porte d'entrée ne ferme plus",
                        "contractReference": "contractMultiservices",
                        "contacts": [
                            "BEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DUPONT\r\nN;CHARSET=UTF-8:DUPONT;Pierre\r\nTEL;TYPE=WORK,VOICE:0734220902\r\nTEL;TYPE=HOME,VOICE:0685874445\r\nADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Locataire\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD"
                        ],
                        "creationDate": "2024-02-29T10:56:30+01:00",
                        "type": "intervention",
                        "serviceCode": "P902",
                        "workType": "corrective",
                        "status": "open",
                        "event": "requested",
                        "eventDate": "2024-02-17T16:00:00+01:00",
                        "logDate": "2024-02-17T16:00:00+01:00",
                        "location": {
                            "assetLabel": "RdC, Porte D",
                            "assetAlgoliaId": "65e047ed4794512d751c2d07",
                            "address": {
                                "way": "9 RUE DU PARADIS",
                                "city": "WAMBRECHIES",
                                "zip": "59118",
                                "country": "FRANCE"
                            },
                            "assetReference": "111578",
                            "assetOwner": "demo.intent",
                            "geo": {
                                "longitude": -4.297238,
                                "latitude": 48.377953
                            }
                        },
                        "equipmentWorkingOrder": "not_operational",
                        "visitAttempt": 1,
                        "criticalLevel": 3
                    },
                    {
                        "issuer": {
                            "entity": {
                                "id": "5853fdefc2829a04502a0734",
                                "label": "Intent Staff",
                                "logoUrl": "https://hubintent.com/intent/entities/logos/fdaf450a-4ae4-4c2b-93cb-5338bd286219"
                            },
                            "user": {
                                "id": "dbb63b64-12f4-451e-ace1-47a22a71bfba",
                                "type": "client",
                                "name": "Service client"
                            }
                        },
                        "reference": "INTER-05062024-4",
                        "description": "Nous accusons réception de votre demande d'intervention",
                        "contractReference": "contractMultiservices",
                        "contacts": [
                            "BEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DUPONT\r\nN;CHARSET=UTF-8:DUPONT;Pierre\r\nTEL;TYPE=WORK,VOICE:0734220902\r\nTEL;TYPE=HOME,VOICE:0685874445\r\nADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Locataire\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD"
                        ],
                        "creationDate": "2024-02-29T10:57:41+01:00",
                        "type": "intervention",
                        "serviceCode": "P902",
                        "workType": "corrective",
                        "status": "open",
                        "event": "acknowledged",
                        "eventDate": "2024-02-17T16:02:00+01:00",
                        "logDate": "2024-02-17T16:02:00+01:00",
                        "location": {
                            "assetLabel": "RdC, Porte D",
                            "assetAlgoliaId": "65e047ed4794512d751c2d07",
                            "address": {
                                "way": "9 RUE DU PARADIS",
                                "city": "WAMBRECHIES",
                                "zip": "59118",
                                "country": "FRANCE"
                            },
                            "assetReference": "111578",
                            "assetOwner": "demo.intent",
                            "geo": {
                                "longitude": -4.297238,
                                "latitude": 48.377953
                            }
                        },
                        "equipmentWorkingOrder": "not_operational",
                        "visitAttempt": 1,
                        "criticalLevel": 3
                    },
                    {
                        "issuer": {
                            "entity": {
                                "id": "5853fdefc2829a04502a073a",
                                "label": "Intent Technologies Tests Internes",
                                "logoUrl": "https://hubintent.com/intent/entities/logos/c74fd223-bc40-46c2-bf42-6748a9cfe146"
                            },
                            "user": {
                                "id": "035aa297-15fe-4cad-8ba3-16451af564d8",
                                "type": "client",
                                "name": "tests api internes"
                            }
                        },
                        "reference": "INTER-05062024-4",
                        "description": "Ajout d'un contact supplémentaire sur l'intervention",
                        "contractReference": "contractMultiservices",
                        "contacts": [
                            "BEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Martin SPAGNOLI\r\nN;CHARSET=UTF-8:SPAGNOLI;Martin\r\nTEL;TYPE=WORK,VOICE:0734220955\r\nTEL;TYPE=HOME,VOICE:0685874400\r\nADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Locataire\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:m.spagnoli@internet.fr\r\nEND:VCARD"
                        ],
                        "creationDate": "2024-02-29T10:59:44+01:00",
                        "type": "intervention",
                        "serviceCode": "P902",
                        "workType": "corrective",
                        "status": "open",
                        "event": "commented",
                        "eventDate": "2024-02-17T16:30:00+01:00",
                        "logDate": "2024-02-17T16:30:00+01:00",
                        "location": {
                            "assetLabel": "RdC, Porte D",
                            "assetAlgoliaId": "65e047ed4794512d751c2d07",
                            "address": {
                                "way": "9 RUE DU PARADIS",
                                "city": "WAMBRECHIES",
                                "zip": "59118",
                                "country": "FRANCE"
                            },
                            "assetReference": "111578",
                            "assetOwner": "demo.intent",
                            "geo": {
                                "longitude": -4.297238,
                                "latitude": 48.377953
                            }
                        },
                        "equipmentWorkingOrder": "not_operational",
                        "visitAttempt": 1,
                        "criticalLevel": 3
                    }
                ],
                "creationDate": "2024-02-29T10:56:30+01:00",
                "lastUpdateDate": "2024-02-29T10:59:44+01:00",
                "_links": {
                    "self": {
                        "href": "https://api.hubintent.com/api/operations/v2/operations/INTER-05062024-4?contractReference=contractMultiservices"
                    },
                    "documents:list": {
                        "href": "https://api.hubintent.com/api/documents/v1/documents?elementType=undefined&elementReference=INTER-05062024-4"
                    }
                }
            }
        ]
    },
    "total": 1
}