announcement

There has been a lapse in Environmental Protection Agency appropriations. EPA intends to keep the ENERGY STAR website, tools, and resources available, however they will not be updated regularly. If you submit a question, application, or request to EPA, it may not be processed during this period.

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