This is the API to create votes as an election provider, register allowed voters and get the results on closed elections.
\nActual votes can also be done directly through the API, however we do recommend using the official webpage have your voters know, that nobody can find out what they voted for.
\nWith this tool, the election provider is to make sure, the voters will get only their registered voterkey when they are allowed to vote.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"25751373","collectionId":"c3e2a82e-269c-48b7-af2c-949975b7cebc","publishedId":"2s935uFKvy","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"233C76"},"publishDate":"2023-02-10T22:28:28.000Z"},"item":[{"name":"Election","item":[{"name":"Admin","item":[{"name":"Create","id":"5b2942b2-7a0c-48c1-b137-15c249e15c9e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"electionName\": \"Vorwahl 1\",\r\n \"startTime\": \"2023-03-15 11:00\",\r\n \"endTime\": \"2023-03-15 16:00\",\r\n \"electionAuthType\": \"none\",\r\n \"voterAuthType\": \"static\",\r\n \"items\": [\r\n {\r\n \"itemTitle\": \"President of the USA\",\r\n \"itemKey\": \"President\",\r\n \"description\": \"The president of the United States of America for a 4 year period\",\r\n \"selectionType\": \"single-choice\",\r\n \"options\": [\r\n {\r\n \"optionKey\": \"Trump\",\r\n \"optionTitle\": \"Donald J. Trump\"\r\n },\r\n {\r\n \"optionKey\": \"Biden\",\r\n \"optionTitle\": \"Joe Biden\"\r\n }\r\n ]\r\n },\r\n {\r\n \"itemTitle\": \"Vicepresident of the USA\",\r\n \"itemKey\": \"Vicepresident\",\r\n \"description\": \"The vicepresident of the United States of America for a 4 year period\",\r\n \"selectionType\": \"multiple-choice-ordered\",\r\n \"options\": [\r\n {\r\n \"optionKey\": \"Harris\",\r\n \"optionTitle\": \"Kamala Harris\"\r\n },\r\n {\r\n \"optionKey\": \"Rice\",\r\n \"optionTitle\": \"Susan Rice\"\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://evoting.cryptit.at/api/election/create","description":"Create a new election, this needs an account API key as authorization.
Once a collection has beend created, voters can access the vote page with the returned publicId and their registered voterKey:
https://evoting.cryptit.at/election/vote/{publicId}?voterKey={voterKey}
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"Create a new election, this needs an account API key as authorization.
Once a collection has beend created, voters can access the vote page with the returned publicId and their registered voterKey:
https://evoting.cryptit.at/election/vote/{publicId}?voterKey={voterKey}
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"Add valid voter keys as the election owner if the election voterAuthType is set to static (if set to dynamic no voter keys need to be predefined)
Remove a voter key as the election owner
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"After an election has ended anybody can request the results hash.
\nThe results can be viewed at
\nhttps://cryptit-e-voting.infura-ipfs.io/ipfs/{result}
(Or any public IPFS gateway)
Vote as a valid voter. The election provider is supposed to give the valid voter key only when the voter is authorized on their platform.
\nThe receipt will view the actual vote at
\nhttps://cryptit-e-voting.infura-ipfs.io/ipfs/{receipt}
\n(Or any public IPFS gateway)
\nIt is recommended to lead the voters to the offical voting page
\nhttps://evoting.cryptit.at/election/vote/{publicId}?voterKey={voterKey}
\nIt is up to the voters themselves to find their receipt in the final results. Anybody will be able to recount every vote, only the voter has a possibility to know their vote within the results through their receipt.
\n","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"9db4c959-b0f5-4412-824c-6cf90e5a8ff4","id":"9db4c959-b0f5-4412-824c-6cf90e5a8ff4","name":"Election","type":"folder"}},"urlObject":{"path":["election","vote"],"host":["https://evoting.cryptit.at/api"],"query":[],"variable":[]}},"response":[{"id":"634782d3-f0f8-4d2b-9094-d71ab671b6f3","name":"Successful response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"publicId\": \"Vorwahl-1-123456\",\r\n \"voterKey\": \"abcd123\",\r\n \"voterHash\": \"hFSnS1eB3nUcpTuFGwzx3wKPs\",\r\n \"votes\": [\r\n {\r\n \"itemTitle\": \"President of the united States\",\r\n \"itemKey\": \"President\",\r\n \"options\": [\r\n {\r\n \"optionKey\": \"Biden\",\r\n \"optionTitle\": \"Joe Biden\"\r\n }\r\n ]\r\n },\r\n {\r\n \"itemTitle\": \"Vicepresident of the united States\",\r\n \"itemKey\": \"Vicepresident\",\r\n \"options\": [\r\n {\r\n \"optionKey\": \"Harris\",\r\n \"optionTitle\": \"Kamala Harris\"\r\n },\r\n {\r\n \"optionKey\": \"Rice\",\r\n \"optionTitle\": \"Susan Rice\"\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://evoting.cryptit.at/api/election/vote"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"receipt\": \"QmeEhFSnS1eB3nUcpTuFGwzx3wKPsLUiYAxasXgUNPxEaz\"\n}"},{"id":"d56d408b-f2b8-4787-b827-bd127090ad65","name":"Bad request (invalid voter)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"publicId\": \"Vorwahl-1-123456\",\r\n \"voterKey\": \"abcd123456\",\r\n \"voterHash\": \"hFSnS1eB3nUcpTuFGwzx3wKPs\",\r\n \"votes\": [\r\n {\r\n \"itemTitle\": \"President of the united States\",\r\n \"itemKey\": \"President\",\r\n \"options\": [\r\n {\r\n \"optionKey\": \"Biden\",\r\n \"optionTitle\": \"Joe Biden\"\r\n }\r\n ]\r\n },\r\n {\r\n \"itemTitle\": \"Vicepresident of the united States\",\r\n \"itemKey\": \"Vicepresident\",\r\n \"options\": [\r\n {\r\n \"optionKey\": \"Harris\",\r\n \"optionTitle\": \"Kamala Harris\"\r\n },\r\n {\r\n \"optionKey\": \"Rice\",\r\n \"optionTitle\": \"Susan Rice\"\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://evoting.cryptit.at/api/election/vote"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"error\": \"Invalid voter\"\r\n}"},{"id":"397532b9-49e9-40dd-a736-d0be9763bd84","name":"Bad request (invalid election)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"publicId\": \"invalid-election\",\r\n \"voterKey\": \"abcd123\",\r\n \"voterHash\": \"hFSnS1eB3nUcpTuFGwzx3wKPs\",\r\n \"votes\": [\r\n {\r\n \"itemTitle\": \"President of the united States\",\r\n \"itemKey\": \"President\",\r\n \"options\": [\r\n {\r\n \"optionKey\": \"Biden\",\r\n \"optionTitle\": \"Joe Biden\"\r\n }\r\n ]\r\n },\r\n {\r\n \"itemTitle\": \"Vicepresident of the united States\",\r\n \"itemKey\": \"Vicepresident\",\r\n \"options\": [\r\n {\r\n \"optionKey\": \"Harris\",\r\n \"optionTitle\": \"Kamala Harris\"\r\n },\r\n {\r\n \"optionKey\": \"Rice\",\r\n \"optionTitle\": \"Susan Rice\"\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://evoting.cryptit.at/api/election/vote"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"ETag","value":"\"3y82aknjmhs\""},{"key":"Content-Length","value":"28"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Fri, 10 Feb 2023 01:56:44 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Invalid election\"\n}"},{"id":"fd0c5cf6-83ab-4811-86e4-41366747d840","name":"Successful secret-key vote","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"publicId\": \"Vorwahl-1-123456\",\r\n \"voterKey\": \"abcd123\",\r\n \"voterHash\": \"hFSnS1eB3nUcpTuFGwzx3wKPs\",\r\n \"secretHash\": \"asdf34thdwgfh21354zhjw2rg\",\r\n \"votes\": [\r\n {\r\n \"itemTitle\": \"President of the united States\",\r\n \"itemKey\": \"President\",\r\n \"options\": [\r\n {\r\n \"optionKey\": \"Biden\",\r\n \"optionTitle\": \"Joe Biden\"\r\n }\r\n ]\r\n },\r\n {\r\n \"itemTitle\": \"Vicepresident of the united States\",\r\n \"itemKey\": \"Vicepresident\",\r\n \"options\": [\r\n {\r\n \"optionKey\": \"Harris\",\r\n \"optionTitle\": \"Kamala Harris\"\r\n },\r\n {\r\n \"optionKey\": \"Rice\",\r\n \"optionTitle\": \"Susan Rice\"\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://evoting.cryptit.at/api/election/vote"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"b96a3448-6d5c-4ec8-8ea1-a8761aebe70b"}],"id":"9db4c959-b0f5-4412-824c-6cf90e5a8ff4","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"e15ba88c-5319-4d31-b5eb-fc5e6aa2607f","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"b119bed7-6544-4fba-b4bf-1cb605bed9ef","type":"text/javascript","exec":[""]}}],"_postman_id":"9db4c959-b0f5-4412-824c-6cf90e5a8ff4","description":""},{"name":"User","item":[{"name":"Request API Key","id":"39c88464-1521-442d-b30f-14407c1b7b40","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"admin@cryptit.at\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://evoting.cryptit.at/api/user/requestkey","description":"Request an API key. This is a beta endpoint and will be removed in production release.
\n","urlObject":{"path":["user","requestkey"],"host":["https://evoting.cryptit.at/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"39c88464-1521-442d-b30f-14407c1b7b40"}],"id":"7072a091-1304-48ea-b9db-1c6fa21cb855","description":"Endpoints for user administration
\n","_postman_id":"7072a091-1304-48ea-b9db-1c6fa21cb855"}],"event":[{"listen":"prerequest","script":{"id":"6a46a990-f47e-43de-93b4-54ad97064d86","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"28bf94a8-3a01-4afa-bd0d-d69fb4aeda13","type":"text/javascript","exec":[""]}}],"variable":[{"key":"host","value":"https://evoting.cryptit.at/api","type":"default"},{"key":"API_KEY","value":"