API de documentation pour les notifications - SMSMobileAPI
Documentation de l'API de notification SMSMobileAPI

Documentation de l'API de notification

Ces points d'accès vous permettent de envoyer des notifications mobiles internes et consulter l'historique des notifications Grâce à l'API SMSMobile, des notifications peuvent être envoyées à un appareil mobile spécifique, puis suivies via le point de terminaison de liste.

Le notification/list Le point de terminaison renvoie l'heure d'envoi et l'heure de distribution de la notification. GMT, y compris les chaînes de date et d'heure complètes et Horodatages Unix.

Besoin d'aide ? api@smsmobileapi.com

Démarrage rapide

URL de base

OBTENIR https://api.smsmobileapi.com
Tous les exemples ci-dessous sont présentés comme OBTENIR demandes de simplicité. notification/envoi Le point de terminaison accepte également POSTE et Corps JSON. Remplacer VOTRE_CLÉ_API avec votre vraie clé.

Exemples

GET https://api.smsmobileapi.com/notification/send?apikey=VOTRE_CLÉ_API&sid=IDENTIFIANT_CIBLE&title=Notification&message=Helloworld&type=notification
GET https://api.smsmobileapi.com/notification/list/?apikey=VOTRE_CLÉ_API
GET https://api.smsmobileapi.com/notification/list/?apikey=YOUR_API_KEY&sidentifiant=TARGET_SIDENTIFIANT&distribued=1&date_from=2026-03-01&date_to=2026-03-18

Authentification

Les points de terminaison de notification s'authentifient à l'aide de clé API paramètre.

Requis aux deux extrémités : La clé API est obligatoire pour notification/envoi et notification/list.

Concepts communs

Cible mobile

Les notifications sont envoyées à un appareil mobile spécifique via SidLe point de terminaison de liste peut filtrer la même cible en utilisant sidentifiant ou Sid.

État distribué

  • distribué=1 signifie que la notification a été diffusée.
  • distribué=0 signifie non distribué.
  • statut_distribué retours distribué ou non distribué.

Dates et fuseaux horaires

  • envoyé_* Les champs représentent la date et l'heure d'envoi de la notification. GMT.
  • distribué_* Les champs représentent la date/heure de distribution en GMT.
  • *_à_unix Les champs sont des horodatages Unix.

Comportement du point de terminaison de la liste

  • Le point de terminaison de liste renvoie toujours un maximum de 200 rangées.
  • Les résultats sont classés du plus récent au plus ancien en fonction de la date et de l'heure d'envoi.
  • Les filtres de date utilisent dateAjout en interne et sont exposés comme date_de_début / date_à.

Erreurs

HTTP Exemple d'erreur Signification
400 {"success":false,"message":"Paramètre requis manquant : apikey."} Manquant ou vide clé API.
400 {"success":false,"message":"Paramètres requis manquants : la clé API et le SID sont obligatoires."} Manquant Sid sur notification/envoi.
400 {"success":false,"message":"Paramètre obligatoire manquant : message."} Manquant message sur notification/envoi.
400 {"success":false,"message":"Format de date invalide. Format attendu : AAAA-MM-JJ."} Invalide date_de_début format sur notification/list.
400 {"success":false,"message":"Valeur distribuée invalide. Valeurs autorisées : 0 ou 1."} Invalide distribué valeur du filtre.
500 {"success":false,"message":"Échec de la connexion à la base de données."} Problème de connexion à la base de données.
500 {"success":false,"message":"Échec de la requête : ..."} Erreur SQL / d'exécution.

Notification – Envoyer

Créer une nouvelle notification pour un appareil mobile cible.

Point final

OBTENIR POSTE https://api.smsmobileapi.com/notification/send

Paramètres de requête / corps

ParamètreTaperDescription
clé API chaîne Requis Votre clé API.
Sid chaîne Requis Identifiant mobile cible.
titre chaîne Facultatif Titre de la notification. Par défaut : Notification.
message chaîne Requis Contenu du message de notification.
taper chaîne Facultatif Type de notification. Par défaut : notification.

Exemple de réponse positive

{ "success": true, "message": "Notification créée.", "id": 22087, "apikey": "YOUR_API_KEY", "sid": "508b004b4aadacc4" }

Notification – Liste

Récupérez les dernières notifications pour une clé API, avec filtrage optionnel.

Point final

OBTENIR https://api.smsmobileapi.com/notification/list/

Paramètres de requête

ParamètreTaperDescription
clé API chaîne Requis Votre clé API.
sidentifiant chaîne Facultatif Filtrer les notifications par mobile cible.
Sid chaîne Facultatif Alias de sidentifiant.
distribué 0 | 1 Facultatif 1 = distribué uniquement, 0 = non distribué uniquement.
date_de_début AAAA-MM-JJ Facultatif Filtrer la date d'envoi à partir d'aujourd'hui.
date_à AAAA-MM-JJ Facultatif Date d'envoi du filtre jusqu'à aujourd'hui.
Le point de terminaison de liste renvoie au maximum 200 affiche les lignes et les trie par notification envoyée la plus récente en premier.

Exemple de réponse positive

{ "success": true, "message": "Notifications récupérées avec succès.", "filters": { "sidentifiant": "508b004b4aadacc4", "distribued": "1", "date_from": "", "date_to": "", "limit": 200 }, "count": 1, "data": [ { "sidentifiant": "508b004b4aadacc4", "title": "Notification", "message": "vers miano", "distribued": "1", "distribued_status": "distributed", "distributed_date_gmt": "2026-03-18", "distributed_time_gmt": "10:18:30", "distributed_at_gmt": "2026-03-18 10:18:30", "distributed_at_unix": 1773829110, "distributed_timezone": "GMT", "sent_date_gmt": "2026-03-18", "sent_time_gmt": "10:15:03", "sent_at_gmt": "2026-03-18 10:15:03", "sent_at_unix": 1773828903, "sent_timezone": "GMT" } ] }

Champs de réponse d'envoi

ChampTaperDescription
succèsbooléenÉtat de la demande.
messagechaîneMessage de résultat lisible par l'humain.
identifiantintID de notification créé dans la base de données.
clé APIchaîneClé API renvoyée.
SidchaîneIdentifiant mobile cible utilisé lors de la création.

Liste des champs de réponse

ChampTaperDescription
succèsbooléenÉtat de la demande.
messagechaîneMessage de résultat lisible par l'humain.
filtresobjetFiltres utilisés par la requête.
compterintNombre de notifications retournées.
donnéestableauListe des notifications.
data[].sidentifiantchaîneIdentifiant mobile cible.
données[].titrechaîneTitre de la notification.
données[].messagechaîneMessage de notification.
données[].distribuéeschaîneDrapeau distribué brut.
data[].distribued_statuschaînedistribué ou non distribué.
data[].distributed_date_gmtchaîneDate de distribution en GMT.
data[].distributed_time_gmtchaîneHeure de distribution en GMT.
données[].distribuées_à_gmtchaîneDate et heure de distribution complètes en GMT.
données[].distribuées_sous_unixentier|nullDistribution de la date et de l'heure au format timestamp Unix.
data[].distributed_timezonechaîneToujours GMT.
data[].sent_date_gmtchaîneEnvoyer la date en GMT.
data[].sent_time_gmtchaîneEnvoyez l'heure en GMT.
data[].sent_at_gmtchaîneDate et heure d'envoi complètes en GMT.
data[].sent_at_unixentier|nullEnvoyer la date et l'heure au format timestamp Unix.
data[].sent_timezonechaîneToujours GMT.
Besoin d'aide ? Contact api@smsmobileapi.com
Conseil : ne publiez jamais votre clé API dans des captures d'écran, des tickets ou des dépôts publics.
Chat en direct
💬 Chat en direct disponible
Vous avez des questions ou besoin d'aide ?
Notre équipe est là pour vous aider !
Entrez votre adresse email
pour nous aider à donner suite à votre demande :
Tableau de bord