announcement

During the current lapse in appropriations, EPA intends to keep the ENERGY STAR website, tools, and resources available, however they will not be updated regularly. Many services may not be available during this time.

Web Service Documentation / Categories / Connection/Share Services / Accept/Reject Pending Connection Requests

Accept/Reject Pending Connection Requests

Updated on July 17, 2013

Description

This web service sends an accept or reject reply to a pending connection request along with an optional note based on the information provided in the XML request.

Version

25.0

HTTP Method

POST

Resource URL

/connect/account/(accountId)

Header

Field Name Value Comments
Authorization Basic credentials
Content-Type application/xml

Authorization Required

Yes

Parameters

Parameter Name Description
accountId Id to the account

XML Schemas

Request/Response Schema Name
Request authorization.xsd
Response response.xsd

Example Requests

The following example accepts the connection request to the account that has an id of 68023.

POST  /connect/account/68023

<?xml version="1.0" encoding="UTF-8"?>
<sharingResponse>
     <action>Accept</action>
     <note>Your connection request has been verified and accepted.</note>
</sharingResponse>

The following example rejects the connection request to the account that has an ID of 11111.

POST  /connect/account/11111

<?xml version="1.0" encoding="UTF-8"?>
<sharingResponse>
     <action>Reject</action>
     <note>Unfortunately we cannot provide services for you at this time.</note>
</sharingResponse>

Example Response

The following example shows that the connection has been established to the account that has an id of 68023. It also includes a link to web service to retrieve the customer.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok"/>
TEST