How To Validate A Phone Number On A Cell Phone On A Network With A Cellphone On A Sim Sims.Com (For A Sims) On A Pc Or Cell Phone (For An Ipad) On An Ipa (For Free

Transcription

1 Global Phone Validation Version 1. WSDL: Product Page: Description: Informatica s Global Phone Validation service is a data validation and enrichment service for phone numbers throughout the world across (### countries and territories). The primary benefits of Informatica s Global Phone Validation service are: Global Phone Number Validation: In 2+ countries/territories and in near-real time Identifies Phone Type: Identifies each phone number as landline, mobile, VoIP, or Freephone Geocodes Coordinates: Geocodes each phone number using latitude and longitude Offers Carrier Identification: Identifies a phone number s carrier Required License Information: The LicenseInfo parameter in our web services provides the authentication credentials to allow the user to invoke the web service. Use the UserID and Password associated with your StrikeIron account in the UserID and Password fields. Alternatively, you can also use your license key obtained from StrikeIron with the password blank. LicenseInfo Field: RegisteredUser Input UserID: Password: [email protected] Password1 License Subscription Information Output LicenseStatusCode: This field returns a numeric code indicating the StrikeIron license action taken as a result of invoking this operation from the User ID and Password used for input. Valid license codes are, 1, and 2. For example, a valid User ID and Password returns the code with a corresponding LicenseStatus value of Valid license key. LicenseStatus: This field returns the status of the StrikeIron User ID and Password corresponding to the LicenseStatusCode. LicenseActionCode: This field returns a numeric code indicating the StrikeIron license action taken as a result of invoking this operation. GetRemainingHits returns the code 5 with a corresponding LicenseAction value of Get remaining hits. LicenseAction: This field returns the license action taken as a result of invoking this operation from the User ID and Password used corresponding to the LicenseActionCode. RemainingHits: This field returns the number of hits against the StrikeIron license key used when invoking this operation. Amount: This field returns the number of hits used from the StrikeIron User ID provided to invoke this operation. Valid license key Decremented hit count 2

2 Available Operations: The available operations for Global Phone Validation are: ValidateNumber GetStatusCodesForMethod GetStatusCodes GetServiceInfo GetRemainingHits Operation: ValidateNumber Input PhoneNumber: A single phone number, or a list of phone numbers separated by commas. All phone numbers must include the country code. Note: Country Phone Codes should follow the conventions defined by the ITU-T recommendations E or , Operation: ValidateNumber Output (ServiceResult) Note: There will be one GlobalPhoneEntryWithStatus node per phone number included in the ValidateNumber input. Number: The number passed in without any decoration CountryCode: International Telephone Union ITU-T Recommendation E.164 numeric country code. Commonly referred to as an International Dialing code, this code is the combination of one, two or three digits identifying a specific country, countries in an integrated numbering plan, or a specific geographic area. 1 InternationalPrefix: The digit, or combination of digits, that must be dialed before a country code when dialing a call to a country other than the one from which the call is being placed. NationalPrefix: The digit, or combination of digits, which must be dialed before an area (city) code when dialing a call to a subscriber from inside his own country but outside his own numbering area. CellPrefix: Dialing prefix that must prepend the National Significant Number for inbound international calls to cellular and\or wireless numbers. This prefix appears between the international Country Code and the National Destination Code in normal dialing procedures. NDC: National Destination Code (NDC) or significant leading digits of national (significant) number. The NDC can be a decimal digit or a combination of decimal digits (not including any prefix) identifying a numbering area within a country (or group of countries included in one integrated numbering plan or a specific geographic area) and/or network/services Commonly referred to as an International City Code or (Numbering Plan) Area Code, the NDC is a nationally optional code field, which combined with the Subscriber's Number (SN) will constitute the national (significant) number of the international E.164-number for geographic areas.

3 SN_From: Subscriber s Number (SN) beginning range (low range) in this block assignment. In many numbering plans the subscriber number contains significant leading digits that (in addition to the NDC) further define the local exchange area and/or service. For example in the North American Numbering Plan the first 3-digits of the subscriber number are known as the Central Office Code or telephone exchange prefix and identify the local (city) level service area. SN_To: Subscriber s Number (SN) ending range (high range) in this block assignment. Uses_NDC: True/false field indicating whether value specified in NDC field is a National Destination Code (area code). If N NDCs are not used in the country s telephone numbering system however the leading digits of a number can be used to determine number use and possible geographic information. Number_Type: Type of service associated with the particular telephone exchange or number. Possible values are: LandLine VoIP Mobile Freephone Special Contaminated true LandLine A Note on Number Portability: Global Phone Validation does not track the change in Number_Type for phone numbers that are ported from one carrier to another or converted from one Number_Type to another (i.e., porting your home phone to a mobile phone number). CarrierName: Name of primary telecom carrier or service provider name the numbering block is assigned to. Language: ISO 639 language code identifying the predominate language within the service area or territory. BELLSOUTH SO BELL en Country: ISO numeric country code 84 ISO: ISO alpha 2 country code US RegionCode: Postal abbreviation or code of the state, province, NC department, territory, or similar division within the country associated with the National Destination Code if any. If a standard national abbreviation does not exist for the region the value will be that specified in International Standard ISO :27 Codes for the representation of names of countries and their subdivisions. RegionName: Common name of the state, province, department, territory, or similar division, if any, identified by the National Destination Code and/or National (Significant) Number. When present, RegionName agrees with those values specified in the International Standard ISO :27 Codes for the representation of names of countries and their subdivisions. City: Name of the geographic area, locale, city, municipality, or service type identified by the national (significant) number. North Carolina Cary

4 TimeZone: Time zone the service area is located in specified using Olson Time Zone Database time zone ID. UTC: Time zone specified as Coordinated Universal Time (UTC) offset. Format is +/-hh:mm DST: True/false flag indicating whether daylight savings time is recognized in this time zone. Latitude: Latitude in decimal degree format of the locale, city, municipality, or other geographically identifiable service area of the exchange. Longitude: Longitude in decimal degree format of the locale, city, municipality, or other geographically identifiable service area of the exchange. ErrorCode: Similar to the ItemStatus, this is a short text description of the result for the number. Possible values are: America/New_York -5: true NoError NoError NotFound NDCNotFound InvalidCountryCode InvalidNumber Operation: ValidateNumber Output (ItemStatus) Valid Number 21 Valid Number 31 Number Not Found 32 NDC Not Found 33 Country Code Not Found 41 Invalid number Operation: ValidateNumber Output (ServiceStatus) StatusNbr: This field returns a number referring to the status of this request. (See GetStatusCodes) StatusDescription: This field returns the description of the status number. (See GetStatusCodes) 2 BatchSuccess "BatchSuccess" success returned for all values checked "Successful" success returned for the single value requested "BatchPartialSuccess" success returned for some of the multiple values checked "BatchFailure" all numbers requested in a multiple request failed "Unsuccessful" the single number requested was not found "InternalError" the program encountered an error Operation: GetStatusCodesForMethod Input (ServiceResult) MethodName: Input a method name to obtain a list of the Status Codes for that method that display in the StatusNbr and StatusDescription fields. Input options are: ValidateNumber, GetStatusCodesForMethod, GetStatusCodes, GetServiceInfo, and GetRemainingHits. See GetStatusCodes for possible return values. ValidateNumber Operation: GetStatusCodes Input

5 Note: The only input needed for this operation is the LicenseInfo data. This operation displays a list of the Status Codes for the Web service that display in the StatusNbr and StatusDescription fields. Operation: GetStatusCodes Output (MethodStatusRecord) MethodName: ValidateNumber 2 Successful 211 Data returned for all input numbers 212 Data returned for some input numbers 3 Unsuccessful 311 No data returned for input numbers MethodName: GetStatusCodesForMethod 2 Found 3 Not Found 4 Invalid Method Name MethodName: GetStatusCodes 2 Found 3 Not Found MethodName: GetServiceInfo 2 Found 3 Not Found Operation: GetServiceInfo Input Note: The only input needed for this operation is the LicenseInfo data. This operation displays the last time the Web service source data was updated. Operation: GetServiceInfo Output (ServiceStatus) StatusNbr: This field returns a status number related to the operation. StatusDescription: This field returns a description of the status number. 3 Not Found Operation: GetRemainingHits Input Note: The only input needed for this operation is the LicenseInfo data. Its only return is the SubscriptionInfo which includes the Remaining Hits.