Les méthodes

API Operations v2

Operations v2.0

Pour tout nouveau raccordement à intentPlaform, l'API Operations v2.0 devra être utilisée. Elle propose à minima toutes les exigences de la v1.0 tout en gérant plus de fonctionnalités et scénarios d'usages.
Action
Verbe
Route HTTP
Créer une intervention
POST
/api/operations/v2/interventions/logs
Créer un devis
POST
/api/operations/v2/quotations/logs
Créer une réserve
POST
/api/operations/v2/reservations/logs
Rechercher une opération par sa référence et son contrat
GET
/api/operations/v2/operations/{reference}
Rechercher une interventions suivant plusieurs paramètres
GET
/api/operations/v2/operations
Rechercher les opérations filles par la référence du parent et le contrat
GET
/api/operations/v2/operations/{reference}/children
Rechercher tous les évènements d'une opération et les opérations filles
GET
/api/operations/v2/operations/{reference}/events


Requêtes

URL
https://apisandbox.hubintent.com/api/operations/v2/interventions/logs
verbe HTTP
POST
{
  "reference": "string",
  "description": "string",
  "contractReference": "string",
  "status": "open",
  "event": "requested",
  "eventDate": "string",
  "logDate": "string",
  "serviceCode": "string",
  "location": {
    "assetReference": "string",
    "address": {
      "way": "string",
      "city": "string",
      "zip": "string",
      "country": "string",
      "complement": "string"
    },
    "geo": {
      "longitude": 0,
      "latitude": 0
    }
  },
  "parentReference": "string",
  "workType": "preventive",
  "contacts": [
    "string"
  ],
  "technicalReason": "vandalism",
  "origin": "pm",
  "documentUrls": [
    "string"
  ],
  "tags": {
    "NouveauTagPerso":"string",
    "TagDeMonChoix":"string"
  },
  "equipmentWorkingOrder": "operational",
  "equipmentStatus": "new",
  "visitAttempt": 0,
  "replacingEquipment": "string",
  "warning": true,
  "warningComment": "string",
  "occupantSignature": "ok",
  "orderReference": "string",
  "orderDocReference": "string",
  "dischargeDocReference": "string",
  "additionalOrder": true,
  "additionalOrderComment": "string",
  "fileKey": "string",
  "criticalLevel": 0,
  "reminderLevel": 0,
  "reminderComment": "string",
  "suggestedProvisionalDate": "string",
  "suggestedTimeSlot": "string"
}


Réponse :


Si le log d'intervention a correctement été créé, vous recevez une réponse 204.

Pour plus d'information

Chacune des requêtes (méthode, url, body et réponse) est détaillée dans l' API Reference . Vous y trouverez également des exemples.
Code erreur API

Si vous publiez des logs d'intervention avec une référence de contrat ou une référence d'asset non connue sur intentPlatform pour votre entité, vos données seront rejetées. Vous recevrez une erreur 400.