WebDAV · OCS · CalDAV · CardDAV · Talk

API Cloud Orneos

Interagissez avec les fichiers, l’agenda, les contacts et les salons Orneos Meet hébergés sur https://app.orneos.eu.

1. Authentification : Mots de passe d’application

L’identité des comptes Orneos est gérée par le fournisseur OpenID Connect d’Orneos. Pour des raisons de sécurité et d’isolation du mot de passe principal (qui protège aussi la messagerie @orneos.eu), les flux d’enregistrement d’appareil tiers sur le cloud sont désactivés.

Pour accéder aux APIs Cloud (WebDAV, OCS, CalDAV, CardDAV, Talk) depuis un script, une intégration serveur ou un client lourd, l’utilisateur crée un mot de passe d’application dédié dans https://app.orneos.eu/settings/user/security (section « Appareils & sessions »), révocable individuellement à tout moment.

  • Authentification HTTP Basic : identifiant:mot-de-passe-application en HTTPS uniquement
  • Pour tous les appels OCS (/ocs/v2.php/...), ajoutez l’en-tête obligatoire OCS-APIRequest: true
  • Préférez ?format=json ou l’en-tête Accept: application/json sur les endpoints OCS

2. Fichiers (WebDAV)

L’espace de stockage Orneos Drive de chaque utilisateur est accessible en WebDAV à la racine https://app.orneos.eu/remote.php/dav/files/<identifiant>/.

Lister un dossier (PROPFIND) et téléverser un fichier (PUT) 
# Lister la racine des fichiers
curl -X PROPFIND -u "alice:APP_PASSWORD" \
  -H "Depth: 1" \
  https://app.orneos.eu/remote.php/dav/files/alice/

# Téléverser un document
curl -X PUT -u "alice:APP_PASSWORD" \
  --data-binary @rapport.pdf \
  https://app.orneos.eu/remote.php/dav/files/alice/Documents/rapport.pdf

3. Profil Cloud et partages (OCS v2)

L’API OCS v2 permet d’interroger l’état du quota de stockage et de gérer les liens de partage Orneos Drive.

Infos utilisateur et création d’un lien de partage 
# Informations de quota
curl -u "alice:APP_PASSWORD" \
  -H "OCS-APIRequest: true" \
  "https://app.orneos.eu/ocs/v2.php/cloud/user?format=json"

# Créer un lien public en lecture seule (shareType=3)
curl -X POST -u "alice:APP_PASSWORD" \
  -H "OCS-APIRequest: true" \
  -d "path=/Documents/rapport.pdf&shareType=3&permissions=1" \
  "https://app.orneos.eu/ocs/v2.php/apps/files_sharing/api/v1/shares?format=json"

4. Agenda (CalDAV) et Contacts (CardDAV)

Les agendas et carnets d’adresses respectent les standards CalDAV (RFC 4791) et CardDAV (RFC 6352) sous https://app.orneos.eu/remote.php/dav/.

  • Découverte principale : https://app.orneos.eu/remote.php/dav/principals/users/<identifiant>/
  • Agendas CalDAV : https://app.orneos.eu/remote.php/dav/calendars/<identifiant>/<agenda>/
  • Contacts CardDAV : https://app.orneos.eu/remote.php/dav/addressbooks/users/<identifiant>/contacts/

5. Orneos Meet / Talk (Salons et messages)

Créez des salons de visioconférence ou publiez des notifications automatisées dans une conversation d’équipe via l’API OCS Talk.

Lister les salons et envoyer un message 
# Lister les conversations
curl -u "alice:APP_PASSWORD" \
  -H "OCS-APIRequest: true" \
  "https://app.orneos.eu/ocs/v2.php/apps/spreed/api/v4/room?format=json"

# Envoyer un message dans le salon <token>
curl -X POST -u "alice:APP_PASSWORD" \
  -H "OCS-APIRequest: true" \
  -d "message=Déploiement terminé avec succès." \
  "https://app.orneos.eu/ocs/v2.php/apps/spreed/api/v1/chat/ROOM_TOKEN?format=json"