diff --git a/README.rst b/README.rst index ec94506..ddca53a 100644 --- a/README.rst +++ b/README.rst @@ -2,27 +2,23 @@ TeleSign ======== -:Info: - For more information, visit the `TeleSign web site `_. - For the latest source code, visit the `TeleSign github repository `_. +**Information**: For more information, visit the `TeleSign website `_ or the `TeleSign Developer Portal `_. -:Author: - Telesign Corp. +**Author**: Telesign Corp. ---------------------------------- TeleSign Web Services: .NET SDK --------------------------------- -**TeleSign Web Services** conform to the `REST Web Service Design Model `_. Services are exposed as URI-addressable resources through the set of *RESTful* procedures in our **TeleSign REST API**. +**TeleSign web services** conform to the `REST Web Service Design Model `_. Services are exposed as URI-addressable resources through the set of *RESTful* procedures in our **TeleSign REST API**. -The **TeleSign .NET SDK** is a Microsoft .NET component that provides an interface to `TeleSign Web Services `_. +The **TeleSign .NET SDK** is a Microsoft .NET component that provides an interface to `TeleSign web services `_. It contains a .NET Framework class library that presents our web services in an intuitive, hierarchical object model, so you can create and manipulate them in the way you're accustomed to. You can use this SDK to build TeleSign‑based .NET applications. Authentication -------------- -**You will need a Customer ID and API Key in order to use TeleSign’s REST API**. If you are already a customer and need an API Key, you can generate one in the `Client Portal `_. If you are not a customer and would like to get an API Key, please contact `support@telesign.com `_ +**You will need a Customer ID and API Key in order to use TeleSign’s REST API**. If you are already a customer and need an API Key, you can generate one in `TelePortal `_. If you are not a customer and would like to get an API Key, please contact `support@telesign.com `_. You supply your credentials to the API either by editing the TeleSign.config.xml file and filling in the CustomerId and SecretKey values or you can create the credentials in code. Passing null to the service constructors uses the file. @@ -67,7 +63,7 @@ You can use the TeleSign .NET SDK in either of two modes. The rich mode is recom +======================+==========================================================================+ | Rich | Provides an object-oriented framework that models web services as | | | high-level actors, and low-level processes as mediator objects. | -| | Automatically parses the JSON data from server responses, and creates | +| | Automatically parses the JSON data from server responses and creates | | | Response objects from it. | | | | +----------------------+--------------------------------------------------------------------------+ @@ -94,51 +90,53 @@ Rich Mode Classes | | | | | ``public PhoneIdStandardResponse StandardLookup(string phoneNumber)`` | | | Retrieves the standard set of details about the specified phone | -| | number. This includes the type of phone (e.g., land line or mobile), | -| | and it's approximate geographic location. | +| | number. This includes the type of phone (for example, land line or | +| | mobile), and its approximate geographic location. | | | ``public PhoneIdScoreResponse ScoreLookup(string phoneNumber)`` | | | Retrieves a score for the specified phone number. This ranks the | | | phone number's "risk level" on a scale from 0 to 1000, so you can | -| | code your web application to handle particular use cases (e.g., to | -| | stop things like chargebacks, identity theft, fraud, and spam). | +| | code your web application to handle particular use cases (for | +| | example, to stop things like chargebacks, identity theft, fraud, | +| | and spam). | | | ``public PhoneIdContactResponse ContactLookup(string phoneNumber)`` | | | In addition to the information retrieved by *standard*, this service | -| | provides the Name & Address associated with the specified phone | +| | provides the name and address associated with the specified phone | | | number. | | | | | | ``public PhoneIdLiveResponse LiveLookup(string phoneNumber)`` | | | In addition to the information retrieved by *standard*, this service | | | provides information about the subscriber status, device status, | -| | roaming status and roaming country. | +| | roaming status, and roaming country. | | | | | | | +----------------------+--------------------------------------------------------------------------+ -| VerifyService.cs | The **VerifyService** class exposes two services for sending users a | +| VerifyService.cs | The **VerifyService** class exposes four services for sending users a | | | verification token (a three to five-digit number). You can use this | -| | mechanism to simply test whether you can reach users at the phone number | +| | mechanism to test whether you can reach users at the phone number | | | they supplied, or you can have them use the token to authenticate | | | themselves with your web application. In addition, this class also | | | exposes a service that allows you to confirm the result of the | | | authentication. | | | | | | You can use this verification factor in combination with *username* | -| | & *password* to provide *two-factor* authentication for higher | +| | and *password* to provide *two-factor* authentication for higher | | | security. | | | | | | ``public VerifyResponse SendSms(string phoneNumber)`` | -| | Send a text message containing the verification code to the | +| | Sends a text message containing the verification code to the | | | specified phone number (supported for mobile phones only). | | | | | | ``public VerifyResponse InitiateCall(string phoneNumber)`` | -| | Calls the specified phone number, and using a recorded message speaks| -| | the verification code to the user. | +| | Calls the specified phone number and uses a recorded message to | +| | speak the verification code to the user. | | | | | | ``public VerifyResponse ValidateCode(`` | | | ``string referenceId,`` | | | ``string verifyCode)`` | | | | -| | Checks the code supplied is correct. You make this call in your | -| | application after users complete the authentication transaction. | +| | Checks that the code supplied is correct. You make this call in | +| | your application after users complete the authentication | +| | transaction. | | | | | | ``public VerifyResponse CheckStatus(string referenceId)`` | | | | @@ -147,7 +145,7 @@ Rich Mode Classes Code Example: PhoneId Contact Lookup ------------------------------------ -These example assume you are using the file for authentication/configuration described above. +These examples assume you are using the file for authentication/configuration described above. >>> string phoneNumber = "+1 555-555-5555";