Opérateur d’un numéro camerounais

Comment l'opérateur est déterminé

Un numéro mobile camerounais compte neuf chiffres et commence par 6. L'opérateur se lit dans les chiffres qui suivent : l'ART attribue les plages par préfixe, et c'est ce plan que l'API applique pour router le message puis le facturer.

La lecture ne s'arrête pas aux trois premiers chiffres. Les plages 654 et 688 sont découpées en sous-plages de cinq et six chiffres, dont certaines ne sont attribuées à personne : 65460 est MTN, 65461 ne l'est pas ; 688960 est Orange, 688965 ne l'est pas. La résolution retient donc toujours le préfixe le plus long qui couvre le numéro.

Ce que l'outil ne dit pas : il lit une plage attribuée, pas un abonné. Il ignore si la ligne est active, et un numéro porté chez un autre opérateur resterait affiché sous sa plage d'origine. Seule la réponse d'un envoi réel indique l'opérateur finalement retenu.

Le plan de numérotation complet

Les 58 règles appliquées par l'API, telles quelles. Le prix indiqué est celui d'un segment.

Ces règles et ces tarifs sont modifiables par l'administration du service ; la page tarifs affiche toujours les prix en vigueur.

Un préfixe non attribué n'est pas une erreur

Quand aucune règle ne couvre le numéro, l'API ne le rejette pas : le message part par la route par défaut, tracé sous l'opérateur DEFAULT et facturé 10 XAF le segment. C'est une différence utile à connaître avant de traiter un fichier de contacts : un préfixe inconnu coûte plus cher, il ne casse rien.

Un numéro invalide, lui, est refusé avant tout débit : moins de neuf chiffres, ne commençant pas par 6, ou ligne fixe. L'API répond alors 400 INVALID_NUMBER.

Le même résultat par l'API

Aucun point d'entrée ne sert uniquement à résoudre un opérateur : celui-ci est renvoyé par l'envoi lui-même, dans le champ operator de la réponse.

curl -X POST 'https://api.sms.gworldship.com/v1/sms' \
  -H 'Authorization: Bearer gsk_votre_cle_api' \
  -H 'Content-Type: application/json' \
  -d '{"to":"+237690000000","text":"Votre code est 12345"}'

{
  "messageId": "8f1c0b2e-4a77-4f1a-9d3e-2b5c7a0e1f44",
  "to": "+237690000000",
  "operator": "ORANGE",
  "segments": 1,
  "priceXaf": 5,
  "status": "QUEUED",
  "balanceAfterXaf": 9995,
  "createdAt": "2026-09-12T08:24:31Z"
}

Les tarifs, eux, s'obtiennent sans authentification :

curl 'https://api.sms.gworldship.com/v1/pricing'

[{"operator":"CAMTEL","priceXaf":7},
 {"operator":"DEFAULT","priceXaf":10},
 {"operator":"MTN","priceXaf":5},
 {"operator":"NEXTTEL","priceXaf":7},
 {"operator":"ORANGE","priceXaf":5}]

Questions fréquentes