https://github.com/Bujupah/dart_ipify

An unofficial client library ipify on dart.
https://github.com/Bujupah/dart_ipify

dart dart-ipify flutter geo-ip-detection geo-location ipify ipify-api

Last synced: about 1 month ago
JSON representation

An unofficial client library ipify on dart.

• Host: GitHub
• URL: https://github.com/Bujupah/dart_ipify
• Owner: Bujupah
• License: mit
• Created: 2020-10-22T16:10:09.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2021-08-30T11:49:06.000Z (about 3 years ago)
• Last Synced: 2024-07-26T21:54:24.475Z (about 1 month ago)
• Topics: dart, dart-ipify, flutter, geo-ip-detection, geo-location, ipify, ipify-api
• Language: Dart
• Homepage: https://pub.dev/packages/dart_ipify
• Size: 50.8 KB
• Stars: 23
• Watchers: 2
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Dart Ipify

**An unofficial client library for Ipify [*``*](https://www.ipify.org/) *A Simple Public IP Address API, Likewise a geographical IP address details API*.**

[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/Bujupah/dart_ipify/blob/master/LICENSE)

[![pub package](https://img.shields.io/pub/v/dart_ipify.svg)](https://pub.dartlang.org/packages/dart_ipify) 

[![Opensource](https://img.shields.io/static/v1?label=opensource&message=❤&color=red)](https://github.com/bujupah/dart_ipify)

[![Workflow](https://github.com/bujupah/dart_ipify/actions/workflows/dart.yml/badge.svg)](https://github.com/Bujupah/dart_ipify/actions)

## About ipify

Using ipify is ridiculously simple. You can get your public IP directly or you can get the precise physical location of a given IP address. so if you only have as much as an IP address, you can still find out its geographical details.

## Meta

- Author: Khalil Mejdi

- Email: [khalil.mejdi](mailto:[email protected])

- Status: maintained, active

## Purpose

This library makes getting your ``public IP address`` or the precise ``geographical details`` of a given IP address with the dart language extremely simple using Ipify's API.

## Installation

```yaml

dependencies:

  dart_ipify: ^1.1.1

```

## Usage

Using this library is very simple. Here's a simple example:

###### IP Address API

```dart

import 'package:dart_ipify/dart_ipify.dart';

void main() async {

  final ipv4 = await Ipify.ipv4();

  print(ipv4); // 98.207.254.136

  final ipv6 = await Ipify.ipv64();

  print(ipv6); // 98.207.254.136 or 2a00:1450:400f:80d::200e

  final ipv4json = await Ipify.ipv64(format: Format.JSON);

  print(ipv4json); //{"ip":"98.207.254.136"} or {"ip":"2a00:1450:400f:80d::200e"}

  // The response type can be text, json or jsonp

}

```

###### IP Geolocation API

```dart

import 'package:dart_ipify/dart_ipify.dart';

void main() async {

  final mygeo = await Ipify.geo('at_apiKeyxxxxxxxxxxxxxxxxxxxxxxx');

  print(mygeo.location);

  final somegeo = await Ipify.geo('at_apiKeyxxxxxxxxxxxxxxxxxxxxxxx', ip: '8.8.8.8');

  print(somegeo);

  final balance = await Ipify.balance('at_apiKeyxxxxxxxxxxxxxxxxxxxxxxx');

  print(balance);

}

```

## Changelog

All library [#changes](/CHANGELOG.md), in descending order.