POST v1/Surveys/{surveyId}/SamplingPoints
User roles allowed to make this request:
DomainAdministrator
PowerUser
RegularUser
LimitedUser
SampleManager
Permissions required to make this request:
SamplingPoint.Write
SamplingPoint.Read
Survey.Read
Has survey type usage restrictions capi
Create a new sampling point.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
surveyId |
The id of the survey |
string |
Required |
Body Parameters
An object describing the details for the new sampling point
SamplingPointCreationModelName | Description | Type | Additional information |
---|---|---|---|
SamplingPointId |
Gets or sets the sampling point unique identifier. |
string |
String length: inclusive between 0 and 128 |
Name |
Gets or sets the name of the sampling point. |
string |
Required |
Description |
Gets or sets the description. |
string |
String length: inclusive between 0 and 4096 |
Instruction |
Gets or sets the instruction link, this is a link to a pdf blob storage. |
string |
String length: inclusive between 0 and 2147483647 |
FieldworkOfficeId |
Gets or sets the associcated fieldwork office id. |
string |
String length: inclusive between 0 and 36 |
GroupId |
Gets or sets the group id. |
string |
String length: inclusive between 0 and 128 |
Stratum |
Stratum the sampling point belongs to |
string |
String length: inclusive between 0 and 128 |
Kind |
Indicates the Kind of the sampling point. The only accepted values are "Regular" and "Spare". If the value is null then we assign this as "Regular" to be backward compatible |
SamplingPointKind |
None. |
Request Formats
application/json, text/json
{ "SamplingPointId": "sample string 1", "Name": "sample string 2", "Description": "sample string 3", "Instruction": "sample string 4", "FieldworkOfficeId": "sample string 5", "GroupId": "sample string 6", "Stratum": "sample string 7", "Kind": 0 }
application/xml, text/xml
<SamplingPointCreationModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/NipoSoftware.Nfield.Manager.Api.Models"> <Description>sample string 3</Description> <FieldworkOfficeId>sample string 5</FieldworkOfficeId> <GroupId>sample string 6</GroupId> <Instruction>sample string 4</Instruction> <Kind>Regular</Kind> <Name>sample string 2</Name> <SamplingPointId>sample string 1</SamplingPointId> <Stratum>sample string 7</Stratum> </SamplingPointCreationModel>
application/x-www-form-urlencoded
SamplingPointId=sample&Name=sample&Description=sample&Instruction=sample&FieldworkOfficeId=sample&GroupId=sample&Stratum=sample&Kind=Nullable`1
multipart/form-data
Sample not available.
Response Information
Resource Description
If successful, this method returns the newly created sampling point
Response Message
HttpResponseMessageName | Description | Type | Additional information |
---|---|---|---|
Version | Version |
None. |
|
Content | HttpContent |
None. |
|
StatusCode | HttpStatusCode |
None. |
|
ReasonPhrase | string |
None. |
|
Headers | Collection of Object |
None. |
|
RequestMessage | HttpRequestMessage |
None. |
|
IsSuccessStatusCode | boolean |
None. |