Lire un appel

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

{
"type": "appel",
"id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
"link": "/equipment/3f1c…",
"url": "https://app.arquos.eu/url",
"fields": {
  "kind": "texte",
  "description": "texte",
  "caller": "texte",
  "receivedAt": "texte",
  "status": "texte",
  "dispatchedAt": "texte",
  "arrivedAt": "texte",
  "releasedAt": "texte",
  "resolvedAt": "texte",
  "cause": "texte",
  "component": "texte",
  "workDone": "texte",
  "signedBy": "texte",
  "stoppedReason": "texte",
  "restartExpected": "texte"
}
}

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

{
"type": "appel",
"id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
"link": "/equipment/3f1c…",
"url": "https://app.arquos.eu/url",
"fields": {
  "kind": "texte",
  "description": "texte",
  "caller": "texte",
  "receivedAt": "texte",
  "status": "texte",
  "dispatchedAt": "texte",
  "arrivedAt": "texte",
  "releasedAt": "texte",
  "resolvedAt": "texte",
  "cause": "texte",
  "component": "texte",
  "workDone": "texte",
  "signedBy": "texte",
  "stoppedReason": "texte",
  "restartExpected": "texte"
}
}

Endpoint & Authentification

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

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`)

string

Le type de l’objet, au singulier.

string

L’identifiant Arquos.

string

Le chemin de la fiche dans Arquos.

string

L’adresse complète de la fiche, à ouvrir dans un navigateur.

object

Les informations de la fiche, par identifiant d’attribut. Toutes sont présentes ; une information non renseignée vaut null.

Show Ses champs

string

Type. Valeurs possibles : personne_bloquee (Personne bloquée), panne (Panne), vandalisme (Vandalisme), bruit (Bruit ou gêne), arret_client (Arrêt demandé), telealarme (Téléalarme en défaut). Peut valoir null.

string

Ce qui est signalé. Un texte. Peut valoir null.

string

Appelant. Un texte. Peut valoir null.

string

Reçu le. Une date et une heure, au format JJ/MM/AAAA HH:MM. Peut valoir null.

string

Statut. Valeurs possibles : ouverte (Non affecté), en_route (En route), sur_place (Sur place), a_l_arret (À l’arrêt), resolue (Résolu). Peut valoir null.

string

Pris en charge à. Une date et une heure, au format JJ/MM/AAAA HH:MM. Peut valoir null.

string

Arrivée sur place. Une date et une heure, au format JJ/MM/AAAA HH:MM. Peut valoir null.

string

Personne libérée à. Une date et une heure, au format JJ/MM/AAAA HH:MM. Peut valoir null.

string

Remis en service le. Une date et une heure, au format JJ/MM/AAAA HH:MM. Peut valoir null.

string

Cause. Un texte. Peut valoir null.

string

Composant. Un texte. Peut valoir null.

string

Travaux réalisés. Un texte. Peut valoir null.

string

Signé par. Un texte. Peut valoir null.

string

Motif de l’arrêt. Un texte. Peut valoir null.

string

Remise en service prévue. Une date, au format JJ/MM/AAAA. Peut valoir null.

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/calls/ID_DE_L_OBJET \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON'

{
"type": "appel",
"id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
"link": "/equipment/3f1c…",
"url": "https://app.arquos.eu/url",
"fields": {
  "kind": "texte",
  "description": "texte",
  "caller": "texte",
  "receivedAt": "texte",
  "status": "texte",
  "dispatchedAt": "texte",
  "arrivedAt": "texte",
  "releasedAt": "texte",
  "resolvedAt": "texte",
  "cause": "texte",
  "component": "texte",
  "workDone": "texte",
  "signedBy": "texte",
  "stoppedReason": "texte",
  "restartExpected": "texte"
}
}

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