Informatique : Interface de protocole d'application (API)
Cette page n'est pas encore traduite
API Functionality
The Volunteer Impact API enables you to request profile data from Volunteer Impact to be used in an external program or application.
Sample API Client
A sample API Client (implemented in C#) is available at: https://github.com/BetterImpact/ApiClient.
Authentication
Our API uses HTTP basic authentication over HTTPS.
API Endpoints: Listing Users
Enterprise: https://api.betterimpact.com/v1/enterprise/users/
Organization: https://api.betterimpact.com/v1/organization/users/
Parameters:
None.
Query parameters:
Parameter | Description | Valid Values / Defaults |
---|---|---|
page_size | The number of results per page. | 1 to 250
Default: 100 |
page_number | The page number to retrieve. | 1 to *
Default: 1 |
include_ custom_fields |
Whether or not to include custom fields in the results. | “true” or “false”
Default: “true” |
include_ qualifications |
Whether or not to include qualifications in the results. | “true” or “false”
Default: “true” |
include_ memberships |
Whether or not to include membership information in the results. | “true” or “false”
Default: “true” |
include_ verified_volunteers_ background_check_ results |
Whether or not to include Verified Volunteers background check information in the results. | “true” or “false”
Default: “true” |
organization_ids | ENTERPRISE ENDPONT ONLY. Comma separated list of organization IDs to return results for. This will return all users who belong to any of the organizations passed. | Comma separated list of valid organization IDs (integers)
Default: All organizations in the enterprise. |
modules | A comma separated list of the module members you would like to return. | You may use the full, or short form for the module names: volunteer / vol client / cli member / mem donor / don administrator / admin Default: All modules. When left out, the modules will be inferred by any {module}_status parameters specified. |
admin_status | A comma separated list of the admin statuses you would like to restrict the results to. | active inactive Default: All statuses. |
client_status | A comma separated list of the client statuses you would like to restrict the results to. | applicant inprocess / in_process accepted inactive archived Default: All statuses. |
donor_status | A comma separated list of the donor statuses you would like to restrict the results to. | prospect active inactive archived Default: All statuses. |
member_status | A comma separated list of the member statuses you would like to restrict the results to. | applicant inprocess / in_process accepted inactive archived Default: All statuses. |
volunteer_status | A comma separated list of the volunteer statuses you would like to restrict to.
You may use “archived” to include all archived sub-types and “inactive” to include all inactive subtypes. |
applicant inprocess accepted inactiveshortterm (or: inactive_short_term) inactivelongterm (or: inactive_long_term) archiveddidntstart (or: archived_didnt_start) archivedrejected (or: archived_rejected) archiveddismissed (or: archived_dismissed) archivedmoved (or: archived_moved) archivedquit (or: archived_quit) archiveddeceased (or: archived_deceased) archivedother (or: archived_other) Default: All statuses. |
updated_since | This parameter will restrict the results to profiles that have changed since the date specified. | DateTimes are required to be in ISO 8601 format (using the format string: “yyyy’-‘MM’-‘dd’T’HH’:’mm’:’ss’.’fffffffK”). Please see this documentation for more information: https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings#the-round-trip-o-o-format-specifier.
Default: Empty. Will return all profiles regardless of their last update. |
Response parameters:
Header Properties:
API Endpoints: Single User
Enterprise: https://api.betterimpact.com/v1/enterprise/users/{user_id}
Organization: https://api.betterimpact.com/v1/organization/users/{user_id}
Parameters:
Query parameters:
None.
Response:
A single user document, containing its own fields, as well as membership documents, custom fields documents, and qualifications documents.
- Qualifications will only be included if your API user credentials have access to the Volunteer module.
- Custom Fields will only be included if your API user credentials have access to at least one module that is specified on the custom field (the intersection between your modules and the ones on the custom field.).
User Properties:
Membership Properties:
Custom Field Properties:
Qualification Properties:
Background Check Properties:
Custom Field Files
Enterprise: https://api.betterimpact.com/v1/enterprise/users/{user_id}/custom_fields/{user_custom_field_id}/file
Organization: https://api.betterimpact.com/v1/organization/users/{user_id}/custom_fields/{user_custom_field_id}/file
- These URLS are specified as the value of the custom field when custom fields are retrieved as part of a single, or list of users.
Parameters:
Query Parameters:
None.
Response:
The file that was requested, as a byte stream.