LogoLogo
cegedim.cloudITCareAPIPrivacy
Français
Français
  • Documentation
  • ITCare
    • ITCare, c'est quoi ?
      • Débuter avec ITCare
      • Démos
    • Enercare
      • Empreinte carbone
    • Notes de mise à jour
  • ITCare API
    • Aperçu
    • Authentication
    • Erreurs
    • Pagination
    • Reference API
      • Démarrage rapide
      • Analytics
        • Matomo
      • Changes
        • Changes
      • Compute
        • Application Servers
        • Backup Policies
        • Containers
        • Environments
        • Instances
        • Platform
        • Resource Filters
        • Resource Types
        • Resources
        • Services
        • Statuses
        • Tag Keys
        • Tag Values
        • Types
      • Databases
        • Databases
        • MariaDB
        • OpenSearch
        • PostgreSQL
        • Redis
        • SQL Server
      • Hardwares
        • Hardwares
      • Messaging
        • Apache Kafka
        • Message Brokers
        • RabbitMQ
      • Networking
        • Domains
        • Load Balancers
        • Network Clusters
        • Networks
      • Operations
        • Actions
        • Operations
      • Storage
        • Glusterfs
        • Overdrive
      • Topology
        • Topology
  • Services
    • Produits
    • Politique de support
    • Politique de patch
    • RACI
  • Analytique
    • Matomo
      • Matomo - Architecture
      • Matomo - Didacticiels
  • Calcul
    • Instances virtuelles
      • Instances virtuelles - Architectures
        • Linux - Renforcement
      • Instances virtuelles - Didacticiels
    • Conteneurs (K8s)
      • K8s - Architecture
        • Hardening
        • Stockage Persistant
      • K8s - Didacticiels
        • Haute Disponibilité
  • Bases de données
    • MariaDB
      • MariaDB - Architecture
      • MariaDB - Didacticiels
    • OpenSearch
      • OpenSearch - Architecture
        • v2 - Changements
      • OpenSearch - Didacticiels
    • PostgreSQL
      • PostgreSQL - Architecture
      • PostgreSQL - Didacticiels
      • PostgreSQL - Mise à jour
    • Redis
      • Redis - Architecture
      • Redis - Didacticiels
      • Redis - Mise à jour
    • SQL Server
      • SQL Server - Architecture
      • SQL Server - Didacticiels
  • Message
    • Apache Kafka
      • Apache Kafka - Architecture
      • Apache Kafka - Didacticiels
      • Apache Kafka - Mise à jour
    • RabbitMQ
      • RabbitMQ - Architecture
      • RabbitMQ - Didacticiels
    • SMS
      • SMS - Didacticiels
  • Securité
    • Advanced Vulnerability Assessment
    • Bot Defense
      • Bot Defense - Architecture
    • Campagne de Phishing
    • Data Masking
      • Data Masking - Didacticiels
  • Surveillance
    • ExtraHop
  • Stockage
    • GlusterFS
      • GlusterFS - Architecture
      • GlusterFS - Didacticiels
    • OverDrive
      • OverDrive - Architecture
    • Stockage Objet
      • Stockage Objet - Architecture
        • Compatibilité API S3
        • Limitation et bonnes pratiques
        • URL pré-signée
        • Politiques de Buckets
        • Configuration de cycle de vie
        • Object Lock
      • Stockage Objet - Didacticiels
        • Gérer des Objects Users
        • Gérer des versions dans un Bucket
        • Gérer l'accès à un Bucket
Powered by GitBook
On this page
  • Documentation de l'API
  • URL et URI de base
  • Sécurité
  • Protocole HTTPS
  • Authentification
  • Format des demandes et réponses HTTP : json
  • Format de la demande HTTP
  • Format de la réponse HTTP
  • Format de la date et de l'heure
  • Nom de l'expéditeur
  • Données personnalisées
  • Réponses PUSH
  • Limites
Export as PDF
  1. Message
  2. SMS

SMS - Didacticiels

PreviousSMSNextAdvanced Vulnerability Assessment

Last updated 1 month ago

Documentation de l'API

La documentation Swagger API est disponible ici :

URL et URI de base

Le chemin de base de l'API Vortext est situé à l'adresse :

Toutes les méthodes sont relatives à cette URL.

Par exemple, si vous voulez obtenir le statut de Vortext, vous devez utiliser :

GET https://messages.cloud.cegedim.com/status

Sécurité

Protocole HTTPS

Toutes les demandes à l'API de Vortext sont effectuées par le protocole HTTP, en utilisant le cryptage de transport TLSv1.

Authentification

Pour l'instant, l'authentification de base est utilisée pour chaque demande faite au service de Vortext.

Chaque demande est complètement apatride, de sorte que vous pouvez utiliser le service Vortext avec une simple ligne decurl.

Si vous ne connaissez pas l'authentification de base, il suffit d'un en-tête de requête http 'Authorization' :

Authorization Basic YWRtaW5pc3RyYXRvc5cnF2NjBTenh3djRuaU5meEV5VFgwaUN4VmNTaHF1djBYU0RIbjY2

L'identifiant utilisé est username:password encodé en base 64. La plupart des bibliothèques vous demanderont simplement de fournir un nom d'utilisateur et un mot de passe.

Format des demandes et réponses HTTP : json

Cette API est principalement destinée à traiter les messages json dans les corps de demande et de réponse http.

Format de la demande HTTP

Utilisez l'en-tête Content-Type : application/json pour indiquer au service Vortext le format du corps de votre requête.

Format de la réponse HTTP

Utilisez l'en-tête Accept : application/json pour indiquer au service Vortext le format que vous souhaitez pour le corps de la réponse.

Format de la date et de l'heure

Comme json ne supporte pas nativement la date et l'heure, tous les paramètres étiquetés comme date dans cette API sont des chaînes au format ISO8601 :

`YYYY-MM-DDTHH:MM:SS.sssZ`

où Z est le fuseau horaire (comme+0200).

Exemples : 2016-06-01T12:27:19.000+0200

Pour les paramètres de requête, n'oubliez pas d'encoder ces paramètres en url.

Nom de l'expéditeur

Vous pouvez personnaliser le nom de l'expéditeur du SMS, au lieu d'un numéro classique tel que "30180". Pour ce faire, veuillez faire une demande dans ITCare à notre équipe en demandant la mise en place de cette fonctionnalité.

Une fois votre compte configuré, tous les SMS envoyés le seront avec ce nom d'expéditeur. Pour l'instant, il n'est pas possible d'avoir plusieurs noms d'expéditeur par compte.

Données personnalisées

En option, vous pouvez ajouter un tag de métadonnées à la demande d'envoi de SMS, afin de marquer les données personnalisées pour ce message.

Le tag ajouté sera récupéré lors de l'obtention des détails du SMS.

Exemple d'envoi de SMS avec un tag de métadonnées :

{ "phoneNumber": "+3361127272727", "message": "Please call me", "metadata": { "myCustomerId": "123de32", "caller": "MyApp 2.2" } }

Réponses PUSH

Il est possible de recevoir des réponses PUSH (appel REST https) dès qu'un client répond à un SMS envoyé précédemment. Pour activer cette fonctionnalité, veuillez faire une demande dans ITCare à notre équipe.

Voici les spécifications des demandes sortantes que vous recevrez une fois activées :

Protocole

https

URL

<votre>

Méthode HTTP

POST

Authentification

Aucun

Content-Type

application/json

Corps du message

{ "response": { "content": "Response of your customer", "answeredAt" : "2020-02-12T13:00:00.000+0000" }, "message": { } }

Limites

Vous pouvez fixer des limites pour éviter les appels multiples / mauvaises boucles et empêcher certaines inondations :

  • total de SMS envoyés par minute

  • total de SMS envoyés par heure

Pour activer cette fonctionnalité, veuillez faire une demande dans ITCare à notre équipe.

pour les services hébergés dans les centres de données cegedim.cloud.

pour les applications tierces qui atteignent Vortext sur Internet.

https://vortext.cloud.cegedim.com
https://messages.cloud.cegedim.com
https://apidocs.cegedim.cloud/swagger-ui/index.html?urls.primaryName=SMSapidocs.cegedim.cloud