La maintenance d’un équipement

curl --request GET \
--url https://api.arquos.eu/api/v2/equipment/ID_DE_L_OBJET/maintenance \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON'

{
"maintained": true,
"pairedReason": "texte",
"state": "en_service",
"call": {
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "type": "personne_bloquee",
  "status": "ouverte",
  "receivedAt": "2026-10-10T09:30:00Z",
  "detail": "texte",
  "restartPlannedOn": "2026-10-10"
},
"lastMaintenanceVisit": "2026-10-10",
"deadline": "2026-10-10",
"next": {
  "day": "2026-10-10",
  "technician": "texte"
},
"sectorTechnician": "texte",
"contract": {
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "number": "texte",
  "plan": "minimal"
},
"breakdowns30Days": 1,
"breakdowns12Months": 1,
"logbook": [
  {}
],
"totalVisits": 1,
"inspection": {},
"announcedInspection": {},
"technicians": [
  {
    "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "name": "texte"
  }
],
"reserves": [
  {}
],
"emergencyPhone": {},
"quotes": [
  {}
],
"partRequests": [
  {}
],
"availability": {
  "rate": 12.5,
  "downtimeHours": 12.5
},
"maintenancePlan": [
  {}
]
}

curl --request GET \
--url https://api.arquos.eu/api/v2/equipment/ID_DE_L_OBJET/maintenance \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON'

{
"maintained": true,
"pairedReason": "texte",
"state": "en_service",
"call": {
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "type": "personne_bloquee",
  "status": "ouverte",
  "receivedAt": "2026-10-10T09:30:00Z",
  "detail": "texte",
  "restartPlannedOn": "2026-10-10"
},
"lastMaintenanceVisit": "2026-10-10",
"deadline": "2026-10-10",
"next": {
  "day": "2026-10-10",
  "technician": "texte"
},
"sectorTechnician": "texte",
"contract": {
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "number": "texte",
  "plan": "minimal"
},
"breakdowns30Days": 1,
"breakdowns12Months": 1,
"logbook": [
  {}
],
"totalVisits": 1,
"inspection": {},
"announcedInspection": {},
"technicians": [
  {
    "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "name": "texte"
  }
],
"reserves": [
  {}
],
"emergencyPhone": {},
"quotes": [
  {}
],
"partRequests": [
  {}
],
"availability": {
  "rate": 12.5,
  "downtimeHours": 12.5
},
"maintenancePlan": [
  {}
]
}

Endpoint & Authentification

Méthode	URL
`GET`	`https://api.arquos.eu/api/v2/equipment/{id}/maintenance`

En-têtes (Headers) :

Authorization: Bearer [VOTRE_JETON_D_API]
X-Arquos-Agency: [IDENTIFIANT_D_AGENCE] (facultatif, voir Agence)

Paramètres de la requête

string

required

L’identifiant de l’objet.

string

L’identifiant de l’agence où agir. Absent : l’agence par défaut du compte. Une agence hors de sa portée est refusée (403).

Réponse (`200`)

boolean

L’équipement est au parc entretenu par l’agence.

string

Pourquoi une intervention y demande deux techniciens, ou null. Peut valoir null.

string

Son état en ce moment. Valeurs possibles : en_service, en_panne, a_l_arret.

object

L’appel en cours, ou null. Peut valoir null.

Show Ses champs

string

L’identifiant Arquos.

string

Le motif de l’appel. Valeurs possibles : personne_bloquee, panne, vandalisme, bruit, arret_client, telealarme.

string

Où en est l’intervention. Valeurs possibles : ouverte, en_route, sur_place, resolue, a_l_arret.

string

Quand l’appel a été reçu.

string

Le motif d’arrêt ou ce que l’appelant a dit. Peut valoir null.

string

La remise en service prévue. Au format AAAA-MM-JJ. Peut valoir null.

string

La dernière visite d’entretien faite. Au format AAAA-MM-JJ. Peut valoir null.

string

La date à laquelle la prochaine visite est due. Au format AAAA-MM-JJ. Peut valoir null.

object

La prochaine visite planifiée, ou null. Peut valoir null.

Show Ses champs

string

Le jour planifié, AAAA-MM-JJ.

string

Le technicien planifié. Peut valoir null.

string

Le technicien du secteur de l’équipement. Peut valoir null.

object

Le contrat d’entretien, ou null. Peut valoir null.

Show Ses champs

string

L’identifiant Arquos.

string

Son numéro. Peut valoir null.

string

Sa formule. Valeurs possibles : minimal, etendu. Peut valoir null.

integer

Les pannes sur trente jours (hors bruit et arrêt demandé).

integer

Les pannes sur douze mois.

object[]

Le carnet d’entretien récent.

integer

Le nombre de passages au carnet.

object

Le dernier contrôle technique : sa date, l’organisme, et ses réserves. Peut valoir null.

object

Le prochain contrôle annoncé, et les techniciens qui peuvent l’accompagner. Peut valoir null.

object[]

Les techniciens de l’agence, pour planifier ou affecter.

Show Chaque élément

string

L’identifiant Arquos.

string

Son nom.

object[]

Les réserves ouvertes.

object

La téléalarme de la cabine : son opérateur, son dernier essai, son état. Peut valoir null.

object[]

Les devis de l’équipement.

object[]

Les pièces demandées ou commandées.

object

La disponibilité, celle du rapport ; null hors du parc suivi. Peut valoir null.

Show Ses champs

number

Le taux de disponibilité sur douze mois, en pourcentage.

number

Les heures d’arrêt sur douze mois.

object[]

Le plan de maintenance de l’équipement.

Les erreurs

Code	Quand
`400`	Requête mal formée ou champ obligatoire manquant.
`401`	Jeton absent, inconnu ou révoqué.
`403`	Agence hors de votre portée.
`404`	Objet introuvable dans vos agences.
`429`	Trop d’appels : réessayez après le délai de l’en-tête Retry-After.

Le corps d’une erreur porte error, sa raison en français. Voir Les erreurs.

curl --request GET \
--url https://api.arquos.eu/api/v2/equipment/ID_DE_L_OBJET/maintenance \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON'

{
"maintained": true,
"pairedReason": "texte",
"state": "en_service",
"call": {
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "type": "personne_bloquee",
  "status": "ouverte",
  "receivedAt": "2026-10-10T09:30:00Z",
  "detail": "texte",
  "restartPlannedOn": "2026-10-10"
},
"lastMaintenanceVisit": "2026-10-10",
"deadline": "2026-10-10",
"next": {
  "day": "2026-10-10",
  "technician": "texte"
},
"sectorTechnician": "texte",
"contract": {
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "number": "texte",
  "plan": "minimal"
},
"breakdowns30Days": 1,
"breakdowns12Months": 1,
"logbook": [
  {}
],
"totalVisits": 1,
"inspection": {},
"announcedInspection": {},
"technicians": [
  {
    "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "name": "texte"
  }
],
"reserves": [
  {}
],
"emergencyPhone": {},
"quotes": [
  {}
],
"partRequests": [
  {}
],
"availability": {
  "rate": 12.5,
  "downtimeHours": 12.5
},
"maintenancePlan": [
  {}
]
}

Démarrer

API REST

Centres d'appels

Agents IA

Référence · Compte

Référence · Recherche

Référence · Équipements

Référence · Relevés

Référence · Contrats

Référence · Import

Référence · Webhooks

Référence · Référentiels

Référence · Affaires

Référence · Appels

Référence · Visites

Référence · Techniciens

Référence · Pièces

Référence · Devis

Référence · Notes

Référence · Écarts et réserves

Référence · Factures

Référence · Clients

Référence · Immeubles

Référence · Contacts

Référence · Secteurs

Référence · Campagnes

Référence · Contrôles techniques

Référence · Sollicitations

Endpoint & Authentification

Paramètres de la requête

Réponse (`200`)

Les erreurs

​Endpoint & Authentification

​Paramètres de la requête

​Réponse (200)

​Les erreurs

Endpoint & Authentification

Paramètres de la requête

Réponse (`200`)

Les erreurs