Skip to main content

​
Endpoint & Authentification

MéthodeURL
POSThttps://app.arquos.eu/api/1.1/wf/generate_token
En-têtes (Headers) :
  • Authorization: Bearer [VOTRE_API_KEY]
  • Content-Type: application/json

​
Paramètres de la requête (Body)

​
agency_id
string
required
Identifiant unique de l’agence.
​
equipment_number
string
required
Numéro de l’équipement concerné.

​
Spécifications de sécurité

Validité du jeton : Le jeton (token) inclus dans l’URL a une durée de validité de 5 minutes. Il doit être généré à chaque nouveau chargement de page sur votre plateforme.

​
Réponse (Success 200)

L’API retourne une URL signée permettant un accès direct à la fiche technique.
​
url
string
URL sécurisée incluant le jeton unique.
{
  "agency_id": "test_agency_01",
  "equipment_number": "ASC_45678"
}

{
  "status": "success",
  "response": {
    "url": "https://app.arquos.eu/equipement?token=SKd10nnKCq1zEs..."
  }
}

​
Utilisation de l’URL

L’URL générée doit être utilisée exclusivement via une redirection externe ou l’ouverture d’un nouvel onglet dans le navigateur de l’utilisateur.
Note sur l’intégration : Pour des raisons de sécurité et d’expérience utilisateur, l’affichage de la fiche via une balise <iframe> n’est pas supporté.
Méthode recommandée :
  1. L’utilisateur clique sur un bouton “Voir la fiche technique” sur votre interface.
  2. Votre backend appelle l’API generate_token.
  3. Vous redirigez l’utilisateur vers l’URL reçue.