SpreadWebServcie.GetUploadRequestStatus Method

获取联系人名单上传的状态.

参数

参数

类型

描述

loginEmail

String

Spread账号的邮箱地址.

APIKey

String

Spread账号的密码或者 API Key which you can retrieve from your Spread account (My account=> Settings).

RequestID

String

SpreadWebServcie.UploadContactListFile 方法返回的RequestID.

返回结果

DatasetException. 如果成功,则返回含有一张Datatable的Dataset,否则返回异常(Exception)。

请在下列表格中找到详细的返回信息:

状态/场景

返回类型

返回信息

成功获取上传状态的信息

Dataset

返回含有一张Datatable的Dataset。请在下列表格中找到返回的Datatable详细的信息。

输入错误的账号或者API Key。

Exception

抛出一个异常含有信息 'Spread Email and Password not match!'。

输入的Request ID不符合Guid格式。

Exception

抛出一个异常含有信息 'Request ID AAAABBBB-CCCC-DDDD-EEEE-FFFFGGGGHHHH is invalid!'。

输入错误的Request ID。

Exception

抛出一个异常含有信息 'You don't have permission to implement the operation!'。

其他错误情况,比如超时。

Exception

抛出一个异常含错误信息。

请在下列表格中找到返回的Datatable详细的信息。

类型

内容

RequestID

Guid

AAAABBBB-CCCC-DDDD-EEEE-FFFFGGGGHHHH

UploadStatus

String

UploadingCompleteError

category_name

String

备注: 上传的联系人名单名称。

UploadTime

DateTime

备注: 开始上传的时间。

TotalCount

Integer

0

NewCount

Integer

0

DuplicateCount

Integer

0

DeletedCount

Integer

0

ExistingCount

Integer

0

SpamCount

Integer

0

UnsubscribedCount

Integer

0

DoNotMailCount

Integer

0

UndeliverableCount

Integer

0

asUnconfirmedCount

Integer

0

InvalidCount

Integer

0

HasUploadNo

Integer

1000

备注: 已经上传的联系人总数。

例子

string loginEmail = "Spread@reasonables.com";

string APIKey = "TEST0000-TEST-0000-TEST-0000TEST0000";

string RequestID = "38806E59-AAAA-BBBB-CCCC-15A7BFC0D226";

SpreadAPI.SpreadWebService MySpread = new SpreadAPI.SpreadWebService();

DataSet result = MySpread.GetUploadRequestStatus(loginEmail, APIKey , RequestID);

Dim loginEmail As String = "Spread@reasonables.com"

Dim APIKey As String = "TEST0000-TEST-0000-TEST-0000TEST0000"

Dim RequestID As String = "38806E59-AAAA-BBBB-CCCC-15A7BFC0D226"

Dim MySpread As New SpreadAPI.SpreadWebService

Dim result As DataSet = MySpread.GetUploadRequestStatus(loginEmail, APIKey, RequestID)

    /**
    * @name     GetUploadRequestStatus
    * @function get contact list upload status
    * @param
    *  RequestID The request id of SpreadWebServcie.UploadContactListFile return .
    * @return
    *          dataset.
    */
    public function GetUploadRequestStatus($loginEmail,$APIKey,$RequestID){
        $array = array(
	        'loginEmail'        => $loginEmail,
	        'APIKey'	    => $APIKey,
	        'RequestID'  => $RequestID

        );
        $Client=new SoapClient("http://service.rspread.com/Service.asmx?WSDL");
        return $Client -> GetUploadRequestStatus( $array );
    }

         
No sample.

参见