API Add Project

From zFairs Contest Management
Revision as of 19:04, 2 December 2020 by Trent (talk | contribs)

Add Project

You can use our api to add a project and it's participants To do this you need to POST a message to your site. Below is an example of what needs to be posted.

fetch('/api/data/project', {
    method:'POST',
    headers:{'Content-Type': 'application/json'},
    body: JSON.stringify({
            Username:'admin username',
            Password: 'password',
            FairId: '9df61f13-474b-442f-ac1f-edca7348ef71', //This value can be found in your url it's the value of f
            Body: {
				Title:'Project Title' //Required
				,CategoryId: 123  //Required
				,SubCategoryId: 123 //optional
				,Plan: 'Project Plan' // optional
				,Abstract: 'Project Abstract'// optional
				,Description: 'Project Description'// optional
                                ,ProjectKey: ’36 char GUID’//optional
                                ,EntryVideoLink: ‘video Link’ //optional
				,CategoryAwardId: 1 // optional
				,SpecialAwardsIds: [1, 2] //optional
				,Participants : [{
					FirstName: 'Jane' //Required
					,LastName: 'Doe' //Required
					,Grade: 6 //Required
					,TeacherId: '9df61f13-474b-442f-ac1f-edca7348ef71' //Required
					,SchoolId: 24 //Required
					,Email: 'jane@example.com'
					,Email1: 'Doe@example.com'
					,Phone: '800-000-0000'
					,Phone1: '800-123-1324'
					,Address: '1219 45th st'
					,Address2: 'APT 3B'
					,City: 'Ogden'
					,State: 'VA'
					,Zip: '65951'
					,Role: 'Student' 
                                        ,ID:  'Student GUID ID' //optional
                                        ,Username: 'Student User Name' //optional
                                        ,Password:  'Student Password' //optional
					,ProfilePicture: { //Optional
						Base64String: 'base64 file string',
						"FileName": "myAwesomeFileDude.png",
						"Caption": "indescribable profile Pic"
					}

				}],
				"Files": [{
           				"Base64String" : "iVBORw0KGgoAAAANSUhEUgAAAQIAA...", //not required if you use DownloadFromUrl
           				"DownloadFromUrl":"http://yoursite.com/somefile.png",//optional can be used in stead of Base64String
           				"FileName": "myAwesomeFile.png",
           				"Caption": "indescribable"
           				},
           				{
           				"Base64String" : "iVBORw0KGgoAAAANSUhEUgAAAQIAA...",
           				"FileName": "myAwesomeFile2.png",
           				"Caption": "indescribable also"
           				},
           				{
           				"DownloadFromUrl":"http://yoursite.com/somefile.png",
           				"FileName": "myAwesomething.pdf",
           				"Caption": "indescribable pdf"
           				}]
			}
        })
})
.then(response => response.json())
.then(data=>{console.log('Success: ',data);})
.catch((error)=>{console.log('Error: ', error);});

Where to get values

Various fields need id values such as CategoryId, CategoryAwardId, and SpecialAwardIds. You can get these values from our API. Check out API Get Info

Additional Optional fields of Participants

A participant record is very similar to a teacher record see API Add Person for optional fields of participants.