Skip to main content

onlinesim 1.0.1 copy "onlinesim: ^1.0.1" to clipboard
onlinesim: ^1.0.1 copied to clipboard

Typed Dart client for the OnlineSim SMS API: numbers, rent, account, free numbers and webhooks, with a built-in offline mock for tests. Flutter and web.

example/main.dart

// Order a number and wait for its SMS code.
//
// Runs offline against the built-in MockOnlineSim by default. With
// ONLINESIM_KEY set (dart run example/main.dart) it uses the real API — that
// orders a real number and spends money.
import 'dart:io';

import 'package:onlinesim/onlinesim.dart';

Future<void> main() async {
  final key = Platform.environment['ONLINESIM_KEY'];
  final mock = key == null ? MockOnlineSim(balance: 5) : null;
  final client = mock?.client() ?? OnlineSim(apiKey: key);

  try {
    final balance = await client.user.balance();
    print('available: ${balance.available} USD');

    final order = await client.numbers.getWithNumber('google', country: 44);
    print('enter ${order.number} in the app');
    mock?.addSmsAfter(order.tzid, 'Your Google code: 123-456', 1);

    final code = await client.numbers.waitCode(
      order.tzid,
      interval: mock == null ? const Duration(seconds: 5) : Duration.zero,
    );
    print('code: $code');
  } on NoNumberException {
    print('no numbers right now, try another country');
  } on ApiException catch (e) {
    print('API error ${e.code}: ${e.message}');
  } on TransportException catch (e) {
    print('network: ${e.message}');
  } finally {
    client.close();
  }
}
0
likes
160
points
29
downloads

Documentation

Documentation
API reference

Publisher

unverified uploader

Weekly Downloads

Typed Dart client for the OnlineSim SMS API: numbers, rent, account, free numbers and webhooks, with a built-in offline mock for tests. Flutter and web.

Homepage
Repository (GitHub)
View/report issues

Topics

#sms #api #onlinesim #otp

License

Apache-2.0 (license)

Dependencies

http

More

Packages that depend on onlinesim