Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bigdatacloudapi/php-api-client

A PHP client for BigDataCloud API connectivity
https://github.com/bigdatacloudapi/php-api-client

api api-client big-data bigdata bigdatacloud bigdatacloud-api bigdatacloudapi fraud-detection geolocation ip-address ip-address-lookup ip-address-tool ip-address-web-service ip-geolocation ip-geolocation-api ip-location ip-lookup php php-library php7

Last synced: 3 months ago
JSON representation

A PHP client for BigDataCloud API connectivity

Awesome Lists containing this project

README 

        
# BigDataCloud PHP API Client



A PHP client for connecting to the API services provided by [BigDataCloud](https://www.bigdatacloud.com).



## What API services does [BigDataCloud](https://www.bigdatacloud.com) offer?



BigDataCloud offers a range of extremely useful and fast APIs that can be utilised in both backend and frontend scenarios.

From validating customer input live to the next generation of IP Geolocation technology, BigDataCloud has an API suitable to your needs.



You can access any and all BigDataCloud APIs with a free API Key.

To get your API Key, just access your account and retrieve it from your [Account Dashboard](https://www.bigdatacloud.com/account).

If you are not yet a customer, it is completely free to join.



### BigDataCloud API Packages



All BigDataCloud APIs are bundled into five different API packages. Each API package has its own subscription plans and pricings. 



You can find more details on the respective API packages page.

- [IP Geolocation Package](https://www.bigdatacloud.com/ip-geolocation)

- [Reverse Geocoding Package](https://www.bigdatacloud.com/reverse-geocoding)

- [Phone & Email Verification Package](https://www.bigdatacloud.com/phone-email-verification)

- [Network Engineering Package](https://www.bigdatacloud.com/network-engineering), and

- [Free API Package](https://www.bigdatacloud.com/free-api) (doesn't require account creation and API key)



## Documentation



For documentation specific to this API client, please read below.

For more specific documentation of the APIs available, including endpoints, request and response data, please visit the respective API package page.



## Authentication / Identification



To use this API client you must have a BigDataCloud API Key.

To get your personal key, just access your account and retrieve it from your [Account Dashboard](https://www.bigdatacloud.com/account).

If you are not yet a customer, it is completely free to join.



Simply provide this key when initiating the php API client, and it will be included in all requests to the BigDataCloud API Server.

See the example below.



## Installation via Composer



  `composer require bigdatacloudapi/php-api-client`



## Manual Installation



1. Download package, extract contents to relevant folder

2. Require "(extracted-location)/src/Client.php" in your PHP script

3. Initiate new client as in below example utilising \BigDataCloud\Api\ namespace

  



## Example usage



```php

communicate('ip-geolocation-full','GET',['ip'=>'8.8.8.8']);



$result=$client->getIpGeolocationFull(['ip'=>'8.8.8.8']);



var_dump($result);

```



## Example output



```javascript

{

    "ip": "8.8.8.8",

    "country": {

        "isoAlpha2": "US",

        "isoAlpha3": "USA",

        "m49Code": 840,

        "isoName": "United States of America (the)",

        "isoAdminLanguages": [

            {

                "isoAlpha3": "eng",

                "isoAlpha2": "en",

                "isoName": "English"

            }

        ],

        "unRegion": "Americas/Northern America",

        "currency": {

            "numericCode": 840,

            "code": "USD",

            "name": "US Dollar",

            "minorUnits": 2

        },

        "wbRegion": {

            "id": "NAC",

            "iso2Code": "XU",

            "value": "North America"

        },

        "wbIncomeLevel": {

            "id": "HIC",

            "iso2Code": "XD",

            "value": "High income"

        },

        "callingCode": "1",

        "countryFlagEmoji": "🇺🇸"

    },

    "location": {

        "isoPrincipalSubdivision": "California",

        "isoPrincipalSubdivisionCode": "US-CA",

        "city": "Mountain View",

        "postcode": "94043",

        "latitude": 37.42,

        "longitude": -122.09,

        "timeZone": {

            "ianaTimeId": "America/Los_Angeles",

            "displayName": "(UTC-08:00) Pacific Time (US & Canada)",

            "effectiveTimeZoneFull": "Pacific Daylight Time",

            "effectiveTimeZoneShort": "PDT",

            "UtcOffsetSeconds": -25200,

            "UtcOffset": "-07",

            "isDaylightSavingTime": true,

            "localTime": "2019-04-06T04:06:39.1691744"

        }

    },

    "lastUpdated": "2019-04-06T09:09:36.1877959Z",

    "network": {

        "registry": "ARIN",

        "registryStatus": "assigned",

        "registeredCountry": "US",

        "registeredCountryName": "United States of America (the)",

        "organisation": "Google LLC",

        "isReachableGlobally": true,

        "isBogon": false,

        "bgpPrefix": "8.8.8.0/24",

        "bgpPrefixNetworkAddress": "8.8.8.0",

        "bgpPrefixLastAddress": "8.8.8.255",

        "totalAddresses": 256,

        "carriers": [

            {

                "asn": "AS15169",

                "asnNumeric": 15169,

                "organisation": "Google LLC",

                "name": "GOOGLE",

                "registry": "ARIN",

                "registeredCountry": "US",

                "registeredCountryName": "United States of America (the)",

                "registrationDate": "2000-03-30",

                "registrationLastChange": "2012-02-25",

                "totalIpv4Addresses": 8698103,

                "totalIpv4Prefixes": 435,

                "totalIpv4BogonPrefixes": 0,

                "rank": 53,

                "rankText": "#53 out of 62,872"

            }

        ],

        "viaCarriers": [

            {

                "asn": "AS7018",

                "asnNumeric": 7018,

                "organisation": "ATT Services Inc.",

                "registeredCountry": "US",

                "registeredCountryName": "United States of America (the)",

                "rank": 2

            },

       		/*........*/

            {

                "asn": "AS31019",

                "asnNumeric": 31019,

                "organisation": "Paulus M. Hoogsteder trading as Meanie",

                "registeredCountry": "NL",

                "registeredCountryName": "Netherlands (the)",

                "rank": 51153

            }

        ]

    },

    "confidence": "low",

    "confidenceArea": [

        {

            "latitude": 18.0256672,

            "longitude": -66.5275345

        },

        /*........*/

        {

            "latitude": 18.0256672,

            "longitude": -66.5275345

        }

    ],

    "securityThreat": "unknown",

    "hazardReport": {

        "isKnownAsTorServer": false,

        "isKnownAsProxy": false,

        "isKnownAsMailServer": false,

        "isKnownAsPublicRouter": false,

        "isBogon": false,

        "isUnreachable": false

    }

}

```