Sesame API — Documentation

Chargement du module…

⚡

Sesame API Explorer

Documentation de référence pour les APIs Sesame. Commencez par lire la section Authentification pour obtenir vos identifiants et un token d'accès, puis explorez les modules.

Modules disponibles

👤

Intérimaires

Missions, bulletins de salaire, CET, avances, documents

employees/index.html

🏢

Clients

Établissements, coefficients de facturation, solvabilité

clients/index.html

📋

Missions

Affectations, avenants, documents de mission

assignments/index.html

📦

Commandes

CRUD commandes avec pagination

orders/index.html

⏱️

Relevés d'Heures

Saisie et validation des relevés d'heures, activités et valorisation

timesheets/index.html

🧾

Facturation

Génération et suivi des factures clients, avoirs, Factur-X

billing/index.html

💶

Paie

Journal de paie, grand-livre, bulletins de salaire PDF

payroll/index.html

ℹ️ Tous les appels API nécessitent un Bearer Token. Consultez la section Authentification pour savoir comment l'obtenir.

🔐

Authentification OAuth2

Les APIs Sesame utilisent le flux Client Credentials. Chaque appel doit être accompagné d'un Bearer Token obtenu au préalable.

Procédure 3 étapes

Obtenir vos identifiants auprès de Solyce

Contactez Solyce pour recevoir un client_id et un client_secret associés à votre application ou environnement. Ces identifiants sont propres à chaque contexte (développement, production, client…).

⚠️ Ne jamais exposer le client_secret dans du code front-end ou un dépôt Git. Il doit rester côté serveur.

Obtenir un token d'accès

Effectuez un appel POST vers l'endpoint token. L'URL peut varier selon l'environnement (dev, prod) ou le client — vérifiez l'URL applicable à votre contexte auprès de Solyce.

Élément	Valeur	Type
`URL`	https://dev.solyce.solyce.cloud/ords/sesame/oauth/token	variable
`Méthode`	POST	fixe
`Authorization`	Basic Base64(client_id:client_secret)	requis
`Content-Type`	application/x-www-form-urlencoded	fixe
`grant_type`	client_credentials	fixe

cURL

# Remplacer CLIENT_ID, CLIENT_SECRET et l'URL selon votre environnement
curl -X POST https://dev.solyce.solyce.cloud/ords/sesame/oauth/token \
  -H "Authorization: Basic $(echo -n 'CLIENT_ID:CLIENT_SECRET' | base64)" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials"

Réponse attendue

{
  "access_token": "eyJhbGciOiJSUzI1NiJ9.eyJzdWIi...",
  "token_type":   "bearer",
  "expires_in":   3600
}

ℹ️ Le token a une durée de vie limitée (généralement 3600 secondes). Renouvelez-le avant expiration en répétant cette requête.

Utiliser le token dans vos appels API

Ajoutez le token obtenu dans le header Authorization de chaque requête, au format Bearer.

Header à inclure

Authorization: Bearer <access_token>

Si absent ou expiré

HTTP 401 Unauthorized

Exemple d'appel authentifié

curl -X GET https://dev.solyce.solyce.cloud/ords/sesame/employees/employees \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIi..."

✅ Le même token fonctionne pour tous les modules (employees, clients, assignments, orders…) tant qu'il n'est pas expiré.