Documentation de l'API de gestion des appels SMSMobileAPI

Documentation de l'API de gestion des appels

Ces points de terminaison vous permettent de récupérer vos Appels manqués, Appels entrants répondus, et Appels sortants Synchronisé depuis l'application mobile SMSMobileAPI vers votre tableau de bord + API.

Important : si l’application mobile fonctionne en arrière-plan, le système téléphonique peut imposer un délai (jusqu’à environ 10 minutes) entre les synchronisations. Vous pouvez toujours ouvrir l’application pour synchroniser manuellement si nécessaire.

Soutien: api@smsmobileapi.com

Recherche

Démarrage rapide

URL de base

OBTENIRhttps://api.smsmobileapi.com

Tous les points de terminaison ci-dessous sont documentés comme OBTENIR demandes. Remplacer VOTRE_CLÉ_API avec votre véritable clé (ne la partagez pas publiquement).

Exemples


GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY


GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc


GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=3247&date_from_ms=1700000000000&date_to_ms=1700864000000

Authentification

Les points de terminaison de gestion des appels s'authentifient à l'aide de clé API Paramètre de requête.

Validation de l'abonnement : Les points de terminaison entrants/sortants valident votre clé API et vérifient la validité de votre abonnement (en fonction de dateLimit >= CURDATE()Si expiré, vous recevrez API expiréeLe point de terminaison des appels manqués peut renvoyer une erreur générique « Clé API manquante » ou des erreurs serveur en fonction des conditions.

Concepts communs

Pagination

Utiliser limite et compenser paginer les résultats.

Horodatage

date_appel_ms est un horodatage UNIX dans millisecondes.
date_heure_appel_utc est stocké sous forme de chaîne de date et d'heure UTC (champ de base de données).
Pour les appels manqués, l'API renvoie un formatage date chaîne de caractères (dérivée d'une valeur en millisecondes).

Recherche

Appels manqués : recherche Correspond à un numéro ou à un nom.
Entrées/Sorties : q correspond au numéro de téléphone ou au nom mis en cache.

Tri (entrant/sortant uniquement)

Le tri est contrôlé par Trier par + répertoire_sort (Champs autorisés uniquement). Les appels manqués sont toujours classés du plus récent au plus ancien.

Erreurs

HTTP	Exemple d'erreur	Signification
400	`{"success":false,"error":"missing_apikey"}`	Manquant ou vide `clé API`.
403	`{"success":false,"error":"invalid_apikey"}`	Clé API introuvable / non reconnue.
403	`{"success":false,"error":"api_expired"}`	Votre abonnement a expiré (`dateLimit` (c'est avant aujourd'hui).
500	`{"success":false,"error":"server_error","detail":"..."}`	Erreur serveur (base de données, SQL, exception).

Remarque : le point de terminaison des appels manqués peut également renvoyer des messages comme Clé API manquante ou des erreurs de préparation SQL, selon la situation.

Liste des appels manqués

Récupérer les appels manqués synchronisés depuis l'appareil mobile.

Point final

OBTENIRhttps://api.smsmobileapi.com/call/missed/list/

Paramètres de requête

Paramètre	Taper	Description
Requis`clé API`	chaîne	Votre clé API liée au téléphone mobile.
Facultatif`compenser`	int	Décalage de pagination (par défaut : `0`).
Facultatif`limite`	int	Nombre maximal de lignes à renvoyer (par défaut : `100`, max: `500`).
Facultatif`recherche`	chaîne	Recherche par numéro ou par nom (SQL LIKE).
Facultatif`date_début`	AAAA-MM-JJ	Filtre à partir d'aujourd'hui (00:00:00). Comparaison avec l'horodatage en millisecondes enregistré.
Facultatif`date_end`	AAAA-MM-JJ	Filtre appliqué jusqu'à aujourd'hui (23:59:59). Comparaison effectuée avec l'horodatage en millisecondes enregistré.

Tri

Corrigé : le plus récent en premier (TRIER PAR date DESC).

Exemple de requête


GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&limit=100&offset=0&search=John&date_start=2026-02-01&date_end=2026-02-24

Exemple de réponse

{ "success": true, "offset": 0, "limit": 100, "count": 2, "data": [ { "number": "+123470000000", "name": "John Doe", "date": "2026-02-24 12:49:39" }, { "number": "+123471111111", "name": "", "date": "2026-02-24 11:12:09" } ] }

Liste des appels entrants

Récupérer les appels entrants répondus synchronisés depuis l'appareil mobile.

Point final

OBTENIRhttps://api.smsmobileapi.com/call/incoming/list/

Paramètres de requête

Paramètre	Taper	Description
Requis`clé API`	chaîne	Votre clé API. Validée par rapport à l'abonnement (`dateLimit`).
Facultatif`limite`	int	Lignes par page (par défaut : `50`, min 1, max `200`).
Facultatif`compenser`	int	Décalage de pagination (par défaut : `0`).
Facultatif`Trier par`	chaîne	Champ de tri (par défaut : `date_appel_ms`). Autorisé: `date_appel_ms`, `date_heure_appel_utc`, `durée_sec`, `numéro de téléphone`, `créé_à`, `nom_en_caché`, `géolocalisation`.
Facultatif`répertoire_sort`	ascendant\|desc	Sens de tri (par défaut : `desc`).
Facultatif`date_from_ms`	entier (ms)	Filtrer où `date_appel_ms >= date_de_début_ms`.
Facultatif`date_to_ms`	entier (ms)	Filtrer où `date_appel_ms <= date_à_ms`.
Facultatif`q`	chaîne	Rechercher (J'AIME) sur `numéro de téléphone` ou `nom_en_caché`.

Exemple de requête


GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=100&offset=0&sort_by=call_date_ms&sort_dir=desc&q=3247

Exemple de réponse

{ "success": true, "apikey": "VOTRE_CLÉ_API", "limit": 100, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": "+12347" }, "count": 2, "rows": [ { "phone_number": "+123470000000", "cached_name": "Matteo Css", "call_date_ms": 1761233379000, "call_datetime_utc": "2026-02-23 12:49:39", "duration_sec": 440, "geo_location": "Belgique", "created_at": "2026-02-24 04:14:38" } ] }

Liste des appels sortants

Récupérer les appels sortants synchronisés depuis l'appareil mobile.

Point final

OBTENIRhttps://api.smsmobileapi.com/call/outgoing/list/

Paramètres de requête

Mêmes paramètres et comportement que pour les appels entrants.

Paramètre	Taper	Description
Requis`clé API`	chaîne	Votre clé API. Validée par rapport à l'abonnement (`dateLimit`).
Facultatif`limite`	int	Lignes par page (par défaut : `50`, max `200`).
Facultatif`compenser`	int	Décalage de pagination (par défaut : `0`).
Facultatif`Trier par`	chaîne	Défaut `date_appel_ms`. Autorisé: `date_appel_ms`, `date_heure_appel_utc`, `durée_sec`, `numéro de téléphone`, `créé_à`, `nom_en_caché`, `géolocalisation`.
Facultatif`répertoire_sort`	ascendant\|desc	Défaut `desc`.
Facultatif`date_from_ms`	entier (ms)	Filtrer à partir de cet horodatage (ms).
Facultatif`date_to_ms`	entier (ms)	Filtrer jusqu'à cet horodatage (ms).
Facultatif`q`	chaîne	Rechercher sur `numéro de téléphone` ou `nom_en_caché`.

Exemple de requête


GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=duration_sec&sort_dir=desc&date_from_ms=1700000000000&date_to_ms=1700864000000

Exemple de réponse

{ "success": true, "apikey": "VOTRE_CLÉ_API", "limit": 50, "offset": 0, "sort_by": "duration_sec", "sort_dir": "desc", "filters": { "date_from_ms": "1700000000000", "date_to_ms": "1700864000000", "q": null }, "count": 1, "rows": [ { "phone_number": "+123490000000", "cached_name": null, "call_date_ms": 1761231000000, "call_datetime_utc": "2026-02-23 12:10:00", "duration_sec": 120, "geo_location": "Belgique", "created_at": "2026-02-24 04:14:37" } ] }

Champs d'appel manqué

Champ	Taper	Description
`succès`	booléen	État de la demande.
`compenser`	int	Décalage de pagination renvoyé.
`limite`	int	Limite de pagination dépassée.
`compter`	int	Nombre de lignes renvoyées dans `données`.
`données`	tableau	Liste des appels manqués.
`données[].nombre`	chaîne	Numéro de téléphone de l'appelant.
`données[].nom`	chaîne	Nom du contact mis en cache (peut être vide).
`data[].date`	chaîne	Chaîne de date et d'heure formatée, dérivée d'un horodatage en millisecondes.

Champs entrants/sortants

Champ	Taper	Description
`succès`	booléen	État de la demande.
`clé API`	chaîne	Renvoyé par l'API (votre clé).
`limite`	int	Nombre de lignes par page renvoyées.
`compenser`	int	Décalage de pagination renvoyé.
`Trier par`	chaîne	Champ de tri appliqué.
`répertoire_sort`	chaîne	Direction de tri appliquée.
`filtres`	objet	Filtres écho (`date_from_ms`, `date_to_ms`, `q`).
`compter`	int	Nombre de lignes renvoyées dans `rangées`.
`rangées`	tableau	Liste des appels.
`lignes[].numéro_de_téléphone`	chaîne	Numéro de téléphone.
`lignes[].nom_caché`	chaîne\|null	Nom du contact mis en cache (peut être nul).
`lignes[].call_date_ms`	int	Horodatage de l'appel en millisecondes.
`lignes[].call_datetime_utc`	chaîne	Champ de date et d'heure UTC (base de données).
`lignes[].duration_sec`	int	Durée en secondes.
`lignes[].geo_location`	chaîne\|null	Étiquette de géolocalisation (peut être nulle/vide).
`lignes[].created_at`	chaîne	Horodatage d'insertion côté serveur.

API et documentation du développeur

Journal des outils et des modifications

Documentation de l'API de gestion des appels

Démarrage rapide

URL de base

Exemples

Authentification

Concepts communs

Pagination

Horodatage

Recherche

Tri (entrant/sortant uniquement)

Erreurs

Liste des appels manqués

Point final

Paramètres de requête

Tri

Exemple de requête

Exemple de réponse

Liste des appels entrants

Point final

Paramètres de requête

Exemple de requête

Exemple de réponse

Liste des appels sortants

Point final

Paramètres de requête

Exemple de requête

Exemple de réponse

Champs d'appel manqué

Champs entrants/sortants

💬 Chat en direct disponible