php api client

php api client

عميل PHP للاتصال بخدمات API التي تقدمها BigDataCloud.

ما هي خدمات API التي تقدمها BigDataCloud؟

تقدم BigDataCloud مجموعة من واجهات برمجة التطبيقات (APIs) المفيدة للغاية والسريعة التي يمكن استخدامها في سيناريوهات الواجهة الخلفية والأمامية. بدءًا من التحقق من صحة مدخلات العملاء مباشرةً وحتى الجيل التالي من تقنية تحديد الموقع الجغرافي عبر بروتوكول الإنترنت (IP)، تمتلك BigDataCloud واجهة برمجة تطبيقات (API) مناسبة لاحتياجاتك.

يمكنك الوصول إلى أي وجميع واجهات برمجة تطبيقات BigDataCloud باستخدام مفتاح واجهة برمجة التطبيقات المجاني. للحصول على مفتاح API الخاص بك، ما عليك سوى الوصول إلى حسابك واستعادته من لوحة تحكم حسابك. إذا لم تكن عميلاً بعد، فالانضمام مجاني تمامًا.

حزم BigDataCloud API

يتم تجميع جميع واجهات برمجة تطبيقات BigDataCloud في خمس حزم API مختلفة. تحتوي كل حزمة API على خطط الاشتراك والأسعار الخاصة بها.

يمكنك العثور على مزيد من التفاصيل على صفحة حزم واجهة برمجة التطبيقات (API) المعنية.

• حزمة تحديد الموقع الجغرافي IP
• عكس حزمة الترميز الجغرافي
• حزمة التحقق من الهاتف والبريد الإلكتروني
• حزمة هندسة الشبكات، و
• حزمة API مجانية (لا تتطلب إنشاء حساب ومفتاح API)

التوثيق

للحصول على الوثائق الخاصة بعميل API هذا، يرجى قراءة ما يلي. للحصول على وثائق أكثر تحديدًا لواجهات برمجة التطبيقات المتاحة، بما في ذلك نقاط النهاية وبيانات الطلب والاستجابة، يرجى زيارة صفحة حزمة واجهة برمجة التطبيقات المعنية.

المصادقة / تحديد الهوية

لاستخدام عميل API هذا، يجب أن يكون لديك مفتاح BigDataCloud API. للحصول على مفتاحك الشخصي، ما عليك سوى الوصول إلى حسابك واستعادته من لوحة تحكم حسابك. إذا لم تكن عميلاً بعد، فالانضمام مجاني تمامًا.

ما عليك سوى توفير هذا المفتاح عند بدء php api client ، وسيتم تضمينه في جميع الطلبات المقدمة إلى خادم BigDataCloud API. انظر المثال أدناه.

التثبيت عبر الملحن

composer require bigdatacloudapi/php-api-client

التثبيت اليدوي

1. قم بتنزيل الحزمة، واستخرج المحتويات إلى المجلد ذي الصلة
2. اطلب "(extracted-location)/src/Client.php" في برنامج PHP النصي الخاص بك
3. قم ببدء عميل جديد كما في المثال أدناه باستخدام مساحة الاسم BigDataCloudApi

استخدام المثال

 <?php

//Installed via Composer
require_once __DIR__ . ' /vendor/autoload.php ' ;

//Installed manually
//Using composer installed location for example, simply reference the /src/Client.php where extracted/installed instead.
//require_once __DIR__ . '/vendor/bigdatacloudapi/php-api-client/src/Client.php';

$ apiKey = " XXX " ; // Your api key found at: https://www.bigdatacloud.com/account

$ client = new  BigDataCloud  Api  Client ( $ apiKey );


/*
Can specify the api endpoint using either camelised magic methods, or by calling the communicate command directly.
Example magic method: "GET" from "ip-geolocation-full" endpoint becomes: getIpGeolocationFull();
*/

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

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

var_dump ( $ result );

إخراج المثال

 {
    "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
    }
}