Difference between revisions of "API Add Project"

From zFairs Contest Management
Line 17: Line 17:
 
,Abstract: 'Project Abstract'// optional
 
,Abstract: 'Project Abstract'// optional
 
,Description: 'Project Description'// optional
 
,Description: 'Project Description'// optional
 +
                                ,ProjectKey: ’36 char GUID’//optional
 +
                                ,EntryVideoLink: ‘video Link’ //optional
 
,CategoryAwardId: 1 // optional
 
,CategoryAwardId: 1 // optional
 
,SpeicalAwardIds: [1, 2] //optional
 
,SpeicalAwardIds: [1, 2] //optional
Line 35: Line 37:
 
,Zip: '65951'
 
,Zip: '65951'
 
,Role: 'Student'  
 
,Role: 'Student'  
 +
                                        ,ID:  'Student GUID ID' //optional
 +
                                        ,Username: 'Student User Name' //optional
 +
                                        ,Password:  'Student Password' //optional
 
,ProfilePicture: { //Optional
 
,ProfilePicture: { //Optional
 
Base64String: 'base64 file string',
 
Base64String: 'base64 file string',

Revision as of 15:58, 9 November 2020

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  //Required
				,Plan: 'Project Plan' // optional
				,Abstract: 'Project Abstract'// optional
				,Description: 'Project Description'// optional
                                ,ProjectKey: ’36 char GUID’//optional
                                ,EntryVideoLink: ‘video Link’ //optional
				,CategoryAwardId: 1 // optional
				,SpeicalAwardIds: [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.