Add endpoint /candidates/totals/aggregates/

[fec-jli]

Summary (required)

This new endpoint /candidates/totals/aggregates/ will consolidate other /candidates/totals/by_xxxx endpoints.
With passing parameters:

"aggregate_by": 
  [
  	  ""
	  "office", 
	  "office-state", 
	  "office-state-district", 
	  "office-party"
  ]

• Resolves Treemap and all elections totals table: Discuss new endpoints for /by_state and /by_state/by_district #5026

Page One (three endpoint call)

1)aggregate_by=office; office=H; election_year=2022
sample endpoint url:
/candidates/totals/aggregates/?aggregate_by=office&election_year=2022&election_full=true&is_active_candidate=true&per_page=100&office=H

local url:
http://127.0.0.1:5000/v1/candidates/totals/aggregates/?aggregate_by=office&election_year=2022&election_full=true&is_active_candidate=true&per_page=100&office=H

2)aggregate_by=office-party; office=H; election_year=2022
sample endpoint url:
/candidates/totals/aggregates/?aggregate_by=office-party&election_year=2022&election_full=true&is_active_candidate=true&per_page=100&office=H

local url:
http://127.0.0.1:5000/v1/candidates/totals/aggregates/?aggregate_by=office-party&election_year=2022&election_full=true&is_active_candidate=true&per_page=100&office=H

3)aggregate_by=office; office=H; min_election_cycle; max_election_cycle
sample endpoint url:
/candidates/totals/aggregates/?aggregate_by=office&min_election_cycle=2018&max_election_cycle=2022&election_full=true&is_active_candidate=true&per_page=100&office=H

local url
http://127.0.0.1:5000/v1/candidates/totals/aggregates/?aggregate_by=office&min_election_cycle=2018&max_election_cycle=2022&election_full=true&is_active_candidate=true&per_page=100&office=H

Page Two (two endpoint call)

1)aggregate_by=office-state; office=H; election_year=2022
sample endpoint url:
/candidates/totals/aggregates/?aggregate_by=office-state&election_year=2022&election_full=true&is_active_candidate=true&per_page=100&office=H

local url:
http://127.0.0.1:5000/v1/candidates/totals/aggregates/?aggregate_by=office-state&election_year=2022&election_full=true&is_active_candidate=true&per_page=100&office=H

2)aggregate_by=office-state-district; office=H; election_year=2022; state=CA
sample endpoint url:
/candidates/totals/aggregates/?aggregate_by=office-state-district&election_year=2022&election_full=true&is_active_candidate=true&per_page=100&office=H&state=CA

local url:
http://127.0.0.1:5000/v1/candidates/totals/aggregates/?aggregate_by=office-state-district&election_year=2022&election_full=true&is_active_candidate=true&per_page=100&office=H&state=CA

Page Three (one endpoint call)

1)aggregate_by=office-state-district; election_year=2022; office=H
sample endpoint url:
/candidates/totals/aggregates/?aggregate_by=office-state-district&election_year=2022&election_full=true&is_active_candidate=true&per_page=100&office=H

local url
http://127.0.0.1:5000/v1/candidates/totals/aggregates/?aggregate_by=office-state-district&election_year=2022&election_full=true&is_active_candidate=true&per_page=100&office=H

Required reviewers

1-2 devs

Impacted areas of the application

/candidate/total/by_office/
/candidate/total/by_office/by_party/

How to test

• Checkout branch, point to dev db
• pytest
• Test above endpoints using in 3 pages on local
• Test more endpoints on local
  1)no aggregate_by, no election_year
  http://127.0.0.1:5000/v1/candidates/totals/aggregates/?election_full=true&per_page=100

(2)aggregate_by=office
http://127.0.0.1:5000/v1/candidates/totals/aggregates/?election_year=2022&election_full=true&per_page=100&aggregate_by=office

(3)aggregate_by=office-state
http://127.0.0.1:5000/v1/candidates/totals/aggregates/?election_year=2022&election_full=true&per_page=100&aggregate_by=office-state&state=CA

(4)aggregate_by=office-office-state-district
http://127.0.0.1:5000/v1/candidates/totals/aggregates/?election_year=2022&election_full=true&per_page=100&aggregate_by=office-state-district

http://127.0.0.1:5000/v1/candidates/totals/aggregates/?page=1&aggregate_by=office-state-district&election_year=2022&election_full=true&sort_null_only=false&sort_nulls_last=false&sort_hide_null=false&per_page=100&state=CA

(5)aggregate_by=office-party
http://127.0.0.1:5000/v1/candidates/totals/aggregates/?election_year=2022&election_full=true&per_page=100&aggregate_by=office-party

[hcaofec]

Great work of creating this flexible endpoint!