What is the ACS SOAP API?
API stands for Application Programming Interface (API). The ACS SOAP API lets clients use Web services to access the data from their Access ACS™ and Facility Scheduler database.
Our API is a collection of web service calls that provide information on username, password, profile data, groups, volunteers, small groups, events and more from the Access ACS database. Developers can use these calls to create dynamic content on their Web sites, validate users of ACS, and create their own custom applications to pull data from our servers.
- Request a Web services security ID or secid. To request a secid, go to the Access ACS API Web site .
- In the code, add a reference to
- After you receive a secid, you can use it to call getLoginToken and return a token for use with other function calls. Note that this token will time out after one hour of non-use.
When getting started, we recommend you use the wsclient. This will help you work with the API and how it relates to your specific data.
After you download and unzip the folder, run the wsclient application. This will give you an easier view in to the calls and your data.
When running the application, select the webservices you want to work with from the URL drop-down. Your available selections are:
- wsca.asmx (General)
- wscea.asmx (Events)
- wscca (Contributions)
We recommend you view the General webservices, even if your end goal involves Events or Contributions. Also, this is where you will create the Token for the calls.
- Click Create Proxy. This will return a list of calls.
Remember. . .
Just like in the implementation of the webservices, to get a token you first need to call getLoginToken. These are invalid after an hour of inactivity and will need to be recreated.
- The fields you need to enter for the corresponding webservice call display in the yellow window. For example, for getLoginToken you need to pass in your secID and ACS siteid or Site number.
- Enter your secid and siteid, then click Call Web Service.
- Click Save as Token. The token displays in the top right of the page. Use this Token for completing other calls in the session.
You can now select other webservice calls, enter the data required in the yellow box, and click Call Web Service. Your results display on the Dataset results tab at the bottom of the page. This should help you work with the calls and as they apply to your data.