CPC - Create
Overview
This documentation describes the API endpoint for creating a new CPC (Checkpoint Communiqué) document using the POST method. The endpoint allows clients to submit a new document to the system, enabling the creation and storage of compliance certificates or other related documentation.
Endpoint
POST /api/v2013/documents
This is the endpoint to which the POST request should be made to create a new document.
Header
The request must include the following headers:
| Field | Type | Description |
|---|---|---|
| Content-Type | String | Specifies the media type of the request body. This header indicates the format of the data being sent to the server. The allowed value is application/json, which means the request body is formatted as JSON. This helps the server understand how to parse and process the incoming data. |
| Authorization | String | Provides the token used to authenticate the request. This header is essential for identifying and verifying the client making the request. The token should be included in the header to gain access to protected resources or services. Ensure that the token is kept secure and is valid for the requested operation. |
| Realm | String | Defines the specific context or environment in which the Clearing-House request is being made. The allowed values are abs, chm, and bch, each representing different operational contexts. This helps the server route the request appropriately based on the specified realm. |
| Accept | String | Specifies the format in which the client expects the server to return the response data. The allowed value is application/json, indicating that the client prefers the response in JSON format. This informs the server of the desired response format, ensuring that the client receives data in a readable and expected format. |
Realm Values for Development:
abs-dev: Represents the development environment for ABS (Access and Benefit-sharing Clearing-House). Use this value when testing or developing features related to ABS in a non-production setting.bch-dev: Indicates the development environment for BCH (Biosafety Clearing-House). This value is used for testing or development purposes related to BCH functionalities.chm-dev: Specifies the development environment for CHM (Central Clearing-House Mechanism). This realm is used when working on features or testing in the CHM context within a development environment.
Headers required to authenticate and define the context and format of the request and response. The Authorization header must contain a valid token, while the Content-Type and Accept headers specify the format of the document and response, respectively. Here are the steps to get the Authorization token.
Query Parameters
The following query parameters can be used to refine the request:
| Field | Type | Description |
|---|---|---|
| schema | String | Defines the schema or format of the document being posted. This field specifies the type of document and the structure it adheres to. The schema value helps the system understand how to interpret and validate the incoming data. It ensures that the document conforms to a predefined format or standard, facilitating consistency and compatibility across different parts of the system. The schema value typically corresponds to a specific schema definition or type that dictates the required fields, data types, and constraints for the document. |
URL Parameters
The following URL parameter is required:
| Field | Type | Description |
|---|---|---|
| uid | String | A unique identifier for the document. This value is case-sensitive and must conform to the regular expression /^[A-Za-z0-9\-_]{11,128}$/. This pattern allows for a combination of uppercase and lowercase letters, numbers, hyphens, and underscores, with a length ranging from 11 to 128 characters. The uid is crucial for uniquely identifying and retrieving the document within the system, ensuring that each document can be distinctly referenced and managed. It plays a key role in operations such as fetching, updating, or deleting the document, as well as in maintaining the integrity of document management processes. |
Validation Errors
The table below provides descriptions for each error type that may appear in the "errors" property. These errors are intended to help identify missing or incorrect fields and values within the document parameter, enabling precise adjustments to meet validation requirements.
| Error Type | Description |
|---|---|
| Error.Mandatory | Indicates a required field is missing. |
| Error.MandatoryAnyOf | Indicates at least one field from a set of mandatory fields is missing. |
| Error.InvalidValue | Indicates the provided value is not valid according to the specified schema. |
| Error.InvalidProperty | Indicates an invalid property or field name. |
| Error.UnspecifiedLocale | Indicates a locale or language code is missing or invalid. |
| Error.UnexpectedTerm | Indicates an unexpected term or parameter. |
| Error.InvalidType | Indicates the provided data type is not valid. |
Request Body
| Title | Field | Mandatory | Type | Example |
|---|---|---|---|---|
| header | Eheader | { "identifier": "63B9CA56-9D43-E877-2A96-2C95986522D5", "schema": "absCheckpointCommunique", "languages": ["en"] } | ||
| Title of this checkpoint communique | title | True | lstring | { "en": "Test Title" } |
| Country issuing this checkpoint communique | government | True | Eterm | { "identifier": "af" } |
| Links to internationally recognized certificate(s) of compliance (IRCC) that relate to this communique | absIRCCs | True | Ereference[] | [ { "identifier": "CB51626B-CF45-2AA0-3A24-459669DDCC34@1" } ] |
| Checkpoint/s that collected or received the information | absCheckpoints | True | Ereference[] | [ { "identifier": "3E387C20-E70C-997B-EABB-BC4C9A1E142F@1" } ] |
| The internationally recognized certificate of compliance (IRCC) is not available | absIRCCsNotAvailable | bool | True | |
| Source of the genetic resource | sourceCountries | Eterm[] | [ { "identifier": "af" } ] | |
| Person or entity who granted prior informed consent (PIC) | entityWhoGrantedPIC | Ereference | { "identifier": "DECLARE-ORGANISATION_19584_20241007134350919@1" } | |
| Subject-matter or genetic resources relevant to the information collected or received | subjectMatter | lstring | { "en": "<div><!--block-->Test Info</div>" } | |
| Specimen data | specimens | Elink[] | [ { "url": "https://www.google.com", "name": "Google", "language": "en" } ] | |
| Taxonomy | taxonomies | Elink[] | [ { "url": "https://www.google.com", "name": "Google", "language": "en" } ] | |
| Geographic coordinates | gisFiles | Elink[] | [ { "url": "/api/v2013/documents/63B9CA56-9D43-E877-2A96-2C95986522D5/attachments/615856/test.json", "name": "test.json", "tag": "Test Tag", "language": "en" } ] | |
| gisMapCenter | EmapLocation | |||
| Person or entity making information available to the checkpoint on the utilization of the genetic resource | personsAtCheckpoint | Ereference[] | [ { "identifier": "DECLARE-ORGANISATION_19584_20241007134350919@1" } ] | |
| Reference or evidence of prior informed consent (PIC) | evidenceOfPIC | lstring | { "en": "<div><!--block-->Test Info</div>" } | |
| Reference or evidence of establishment of mutually agreed terms (MAT) | evidenceOfMAT | lstring | { "en": "<div><!--block-->Test Info</div>" } | |
| Person or entity to whom prior informed consent (PIC) was granted | entityToWhomPICGranted | Ereference | { "identifier": "DECLARE-ORGANISATION_19584_20241007134350919@1" } | |
| Short description of the information collected or received by the checkpoint relevant to the utilization of genetic resources, including the type of use | description | True | lstring | { "en": "<div><!--block-->Test Info</div>" } |
| Date of access to the genetic resources | dateOfAccess | DateTime | 2024-10-24 | |
| Date on which the information was collected or received at the checkpoint | dateCollected | DateTime | 2024-10-26 | |
| FROM | dateCollectedFrom | DateTime | 2024-10-01 | |
| TO | dateCollectedTo | DateTime | 2024-10-23 | |
| Additional Information | relevantInformation | lstring | { "en": "<div><!--block-->Test Info</div>" } | |
| Other relevant website addresses and/or attached documents | relevantDocuments | Elink[] | [ { "url": "https://www.google.com", "name": "Google", "language": "en" } ] | |
| Keywords to describe the subject-matter or genetic resource(s) covered by the permit or its equivalent | keywords | Eterm[] | [ { "identifier": "term-id-1" }, { "identifier": "term-id-2" } ] | |
| Other keywords | keywordOther | lstring | { "en": "Test Keywords" } |
Playground
Swagger playground is loading, please wait...