E.164 — это международный формат телефонного номера: знак плюса, код страны и национальный номер, всего до 15 цифр, без пробелов, начального нуля и знаков препинания.
E.164 — рекомендация ITU-T, сектора стандартизации Международного союза электросвязи. Она определяет, как записывается телефонный номер для международного использования: знак плюса, код страны из 1–3 цифр, затем национальный номер, всего не более 15 цифр. +14155550142 и +447700900123 соответствуют E.164, а 07700 900123 и (415) 555-0142 — нет.
Преобразование местного номера состоит из трёх шагов: удалить пробелы, скобки и дефисы; отбросить междугородный префикс — цифру, которую набирают перед национальным номером внутри страны (0 в большинстве стран, 1 в США и Канаде); затем добавить знак плюса и код страны. Некоторые страны выбиваются из общих правил: например, номера стационарных телефонов в Италии начинаются с 0, который входит в сам номер, а не служит междугородным префиксом, поэтому он сохраняется после кода страны. Коды выхода на международную связь, например 00 или 011, — это указания для набора, а не часть номера, и в E.164 они исчезают.
API используют E.164, потому что этот формат однозначен. По префиксу можно определить страну, а значит, и маршрут, цену и правило для отправителя. Для интерпретации местных форматов нужна страна по умолчанию, а одни и те же цифры в разных странах могут означать разные номера: в условном списке 0612345678 может оказаться как французским, так и нидерландским мобильным номером — в зависимости от того, кто его записал.
Типичные ошибки в основном связаны с вводом и хранением данных. Электронная таблица, которая воспринимает номера как числа, удаляет знак плюса и начальный ноль или переводит длинные номера в экспоненциальную запись, теряя цифры. Североамериканский номер, уже записанный с начальной 1, получает второй код страны. Номера, сохранённые с пробелами, не проходят строгую проверку. А корректный формат доказывает лишь то, что номер может существовать, но не то, что он обслуживается; разницу объясняют статьи MSISDN и HLR-запрос.
В SMSMeteor: API принимает телефонные номера в формате E.164 с начальным плюсом. Если значение to не является допустимым номером E.164, запрос отклоняется с ошибкой invalid_number ещё до какой-либо отправки, а префикс без маршрута отклоняется с ошибкой unsupported_destination; ни то, ни другое не тарифицируется. Импортёр в панели преобразует местные форматы в E.164, если задана страна по умолчанию, объединяет дубликаты и перечисляет неверные строки. Проверка маршрута показывает направление, тариф и правило для отправителя по отдельному номеру.
