POST project/createProject?Token={Token}
Create project in the system. Privilege "New" of licensed agenda "Projects.Projects" required. No record permissions restriction implemented.
Request Information
Authorization
- Authorization by token required
Availability
- Method disabled by configuration
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
Token |
The action is authorized by this token. Token should generated by calling action "POST login". Expiration time of each token is 20 seconds |
globally unique identifier |
Required |
Body Parameters
ProjectCreateReqName | Description | Type | Additional information |
---|---|---|---|
Code |
Unique identification of the project in the system |
string |
Required String length: inclusive between 0 and 100 |
Name |
The name of the project |
string |
Required String length: inclusive between 0 and 100 |
Type |
The name of the project type |
string |
Required String length: inclusive between 0 and 100 |
Name2 |
Alternative name of the project |
string |
String length: inclusive between 0 and 100 |
Shortcut |
The project shortcut |
string |
String length: inclusive between 0 and 10 |
Code2 |
Identification of the project |
string |
String length: inclusive between 0 and 100 |
Description |
Project description |
string |
String length: inclusive between 0 and 4000 |
PlannedFrom |
The scheduled begin of the project in format "yyyy-MM-ddTHH:mi:ss". |
date |
Data type: Date |
PlannedTo |
The scheduled end of the project in format "yyyy-MM-ddTHH:mi:ss". |
date |
Data type: Date |
Started |
The real begin date of the project in format "yyyy-MM-ddTHH:mi:ss". |
date |
Data type: Date |
Finished |
The real end date of the project in format "yyyy-MM-ddTHH:mi:ss". |
date |
Data type: Date |
Closed |
The real closing date of the project in format "yyyy-MM-ddTHH:mi:ss". |
date |
Data type: Date |
SuperiorProjectCode |
Identification of the superior project in the system |
string |
String length: inclusive between 0 and 100 |
Street |
The address of project |
string |
String length: inclusive between 0 and 100 |
HouseNr |
The address of project |
string |
String length: inclusive between 0 and 10 |
City |
The address of project |
string |
String length: inclusive between 0 and 100 |
PostalCode |
The address of project |
string |
String length: inclusive between 0 and 30 |
PersonIDInCharge |
The identification of the official person in charge by using PersonalID |
string |
String length: inclusive between 0 and 100 |
PersonIDResolver |
The identification of the resolver by using PersonalID |
string |
None. |
Request Formats
application/json
{"PersonIDResolver":"X0001","Code":"CODE 1001","Name":"Name of the project 1001","Type":"Name of the project Type 1001","Name2":null,"Shortcut":null,"Code2":null,"Description":"Description of the project 1001","PlannedFrom":"\/Date(1546326000000)\/","PlannedTo":"\/Date(1549004400000)\/","Started":"\/Date(1546498800000)\/","Finished":"\/Date(1548522000000)\/","Closed":"\/Date(1548572400000)\/","SuperiorProjectCode":"","Street":"Street 5","HouseNr":"HouseNr 5","City":"City 5","PostalCode":"ZIP 5","PersonIDInCharge":"X0004"}
application/xml
<Request> <PersonIDResolver>X0001</PersonIDResolver> <Code>CODE 1001</Code> <Name>Name of the project 1001</Name> <Type>Name of the project Type 1001</Type> <Description>Description of the project 1001</Description> <PlannedFrom>2019-01-01T08:00:00</PlannedFrom> <PlannedTo>2019-02-01T08:00:00</PlannedTo> <Started>2019-01-03T08:00:00</Started> <Finished>2019-01-26T18:00:00</Finished> <Closed>2019-01-27T08:00:00</Closed> <SuperiorProjectCode /> <Street>Street 5</Street> <HouseNr>HouseNr 5</HouseNr> <City>City 5</City> <PostalCode>ZIP 5</PostalCode> <PersonIDInCharge>X0004</PersonIDInCharge> </Request>
text/json
{ "PersonIDResolver": "sample string 1", "Code": "sample string 1", "Name": "sample string 2", "Type": "sample string 3", "Name2": "sample string 4", "Shortcut": "sample string 5", "Code2": "sample string 6", "Description": "sample string 7", "PlannedFrom": "2024-12-03T18:24:22.6991828+01:00", "PlannedTo": "2024-12-03T18:24:22.6991828+01:00", "Started": "2024-12-03T18:24:22.6991828+01:00", "Finished": "2024-12-03T18:24:22.6991828+01:00", "Closed": "2024-12-03T18:24:22.6991828+01:00", "SuperiorProjectCode": "sample string 8", "Street": "sample string 9", "HouseNr": "sample string 10", "City": "sample string 11", "PostalCode": "sample string 12", "PersonIDInCharge": "sample string 13" }
text/xml
<Request xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <PersonIDResolver>sample string 1</PersonIDResolver> <Code>sample string 1</Code> <Name>sample string 2</Name> <Type>sample string 3</Type> <Name2>sample string 4</Name2> <Shortcut>sample string 5</Shortcut> <Code2>sample string 6</Code2> <Description>sample string 7</Description> <PlannedFrom>2024-12-03T18:24:22.6991828+01:00</PlannedFrom> <PlannedTo>2024-12-03T18:24:22.6991828+01:00</PlannedTo> <Started>2024-12-03T18:24:22.6991828+01:00</Started> <Finished>2024-12-03T18:24:22.6991828+01:00</Finished> <Closed>2024-12-03T18:24:22.6991828+01:00</Closed> <SuperiorProjectCode>sample string 8</SuperiorProjectCode> <Street>sample string 9</Street> <HouseNr>sample string 10</HouseNr> <City>sample string 11</City> <PostalCode>sample string 12</PostalCode> <PersonIDInCharge>sample string 13</PersonIDInCharge> </Request>
Response Information
Response Codes
Http Code | Error Number | Description |
---|---|---|
200 request succesfully done | 0 | Processed with result: ExecOK |
202 request accepted | 1291 | Request accepted but some participants [{0}] already exist in the system |
400 bad request | 1002 | Entry parameter missing or parameter bindigs failed |
401 unauthorized | 1000 | Token {0} not found |
401 unauthorized | 1001 | Token {0} already expired |
401 unauthorized | 1006 | Ip filter violated for ip client address [{0}] |
401 unauthorized | 1007 | Ip filter [{0}] parsing failed |
401 unauthorized | 1008 | Request rate policy violated for [{0}] |
403 server refuses fo fulfill the request | 1286 | Privilege New of agenda Projects.Projects violated for [{0}] |
403 server refuses fo fulfill the request | 1 | Db operation failed, agenda missing priviliges |
403 server refuses fo fulfill the request | 2 | Db operation failed, record missing priviliges |
403 server refuses fo fulfill the request | 3 | Db operation failed, Record duplicity |
403 server refuses fo fulfill the request | 4 | Db operation failed, already changed by another user |
403 server refuses fo fulfill the request | 5 | Db operation failed, already deleted by another user |
403 server refuses fo fulfill the request | 6 | Db operation failed, database data consistence violation |
403 server refuses fo fulfill the request | 7 | Db operation failed, operation can not be executed because another problems occured |
403 server refuses fo fulfill the request | 8 | Db operation failed, licence violation |
403 server refuses fo fulfill the request | 1285 | Unique key Project code {0} is not unique |
404 required resource does not exist on the server | 1287 | The key ProjectType.Name {0} is unknown |
404 required resource does not exist on the server | 1100 | PersonId [{0}] not found |
404 required resource does not exist on the server | 1288 | The superior Project.Code {0} not found |
415 unsupported Media Type | The request entity has a media type which the server or resource does not support. Only application/json and application/xml are supported | |
500 internal error | Server exception description |
Resource Description
BaseRespOfProjectCreateReqName | Description | Type | Additional information |
---|---|---|---|
Result | RequestResult |
None. |
|
Request | ProjectCreateReq |
None. |
Response Formats
application/json
{"Result":{"Message":"Processed with result: ExecOK","Code":0,"ModelStateErr":null},"Request":{"PersonIDResolver":"X0001","Code":"CODE 1001","Name":"Name of the project 1001","Type":"Name of the project Type 1001","Name2":null,"Shortcut":null,"Code2":null,"Description":"Description of the project 1001","PlannedFrom":"\/Date(1546326000000)\/","PlannedTo":"\/Date(1549004400000)\/","Started":"\/Date(1546498800000)\/","Finished":"\/Date(1548522000000)\/","Closed":"\/Date(1548572400000)\/","SuperiorProjectCode":"","Street":"Street 5","HouseNr":"HouseNr 5","City":"City 5","PostalCode":"ZIP 5","PersonIDInCharge":"X0004"}}
application/xml
<Response> <Result> <Message>Processed with result: ExecOK</Message> <Code>0</Code> </Result> <Request> <PersonIDResolver>X0001</PersonIDResolver> <Code>CODE 1001</Code> <Name>Name of the project 1001</Name> <Type>Name of the project Type 1001</Type> <Description>Description of the project 1001</Description> <PlannedFrom>2019-01-01T08:00:00</PlannedFrom> <PlannedTo>2019-02-01T08:00:00</PlannedTo> <Started>2019-01-03T08:00:00</Started> <Finished>2019-01-26T18:00:00</Finished> <Closed>2019-01-27T08:00:00</Closed> <SuperiorProjectCode /> <Street>Street 5</Street> <HouseNr>HouseNr 5</HouseNr> <City>City 5</City> <PostalCode>ZIP 5</PostalCode> <PersonIDInCharge>X0004</PersonIDInCharge> </Request> </Response>
text/json
{ "Result": { "Message": "sample string 1", "Code": 2, "ModelStateErr": [ "sample string 1", "sample string 2" ] }, "Request": { "PersonIDResolver": "sample string 1", "Code": "sample string 1", "Name": "sample string 2", "Type": "sample string 3", "Name2": "sample string 4", "Shortcut": "sample string 5", "Code2": "sample string 6", "Description": "sample string 7", "PlannedFrom": "2024-12-03T18:24:22.7148107+01:00", "PlannedTo": "2024-12-03T18:24:22.7148107+01:00", "Started": "2024-12-03T18:24:22.7148107+01:00", "Finished": "2024-12-03T18:24:22.7148107+01:00", "Closed": "2024-12-03T18:24:22.7148107+01:00", "SuperiorProjectCode": "sample string 8", "Street": "sample string 9", "HouseNr": "sample string 10", "City": "sample string 11", "PostalCode": "sample string 12", "PersonIDInCharge": "sample string 13" } }
text/xml
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Result> <Message>sample string 1</Message> <Code>2</Code> <ModelStateErr> <string>sample string 1</string> <string>sample string 2</string> </ModelStateErr> </Result> <Request> <PersonIDResolver>sample string 1</PersonIDResolver> <Code>sample string 1</Code> <Name>sample string 2</Name> <Type>sample string 3</Type> <Name2>sample string 4</Name2> <Shortcut>sample string 5</Shortcut> <Code2>sample string 6</Code2> <Description>sample string 7</Description> <PlannedFrom>2024-12-03T18:24:22.7148107+01:00</PlannedFrom> <PlannedTo>2024-12-03T18:24:22.7148107+01:00</PlannedTo> <Started>2024-12-03T18:24:22.7148107+01:00</Started> <Finished>2024-12-03T18:24:22.7148107+01:00</Finished> <Closed>2024-12-03T18:24:22.7148107+01:00</Closed> <SuperiorProjectCode>sample string 8</SuperiorProjectCode> <Street>sample string 9</Street> <HouseNr>sample string 10</HouseNr> <City>sample string 11</City> <PostalCode>sample string 12</PostalCode> <PersonIDInCharge>sample string 13</PersonIDInCharge> </Request> </Response>