Genesys BrAPI reference manual

March 2017: Documentation commit d83c996
version 2024.1

Genesys implements basic BrAPI v1 specification

All API access is over HTTPS, and accessed from the https://api.genesys-pgr.org domain or through https://api.sandbox.genesys-pgr.org for testing purposes. All data is sent and received as JSON. In this manual, all URLs are pointing to the Genesys sandbox environment at https://api.sandbox.genesys-pgr.org.

1. Authentication

All BrAPI requests require OAuth2 authentication header in HTTP requests:

Authorization: Bearer <TOKEN>

1.1. Login

Genesys does not support the /login endpoint. You must obtain the OAuth access token as described in Genesys API manual.

1.2. Logout

Genesys does not support the /logout endpoint.

2. Crops

/brapi/v1/crops endpoint allows for retrieving the list of Genesys crops.

Unresolved directive in brapi/crops.adoc - include::/builds/genesys-pgr/genesys-server/build/generated-snippets/brapi-crops/curl-request.adoc[]

2.1. Request parameters

Unresolved directive in brapi/crops.adoc - include::/builds/genesys-pgr/genesys-server/build/generated-snippets/brapi-crops/request-parameters.adoc[]

2.2. Server response

Genesys returns the standard BrAPI Germplasm response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
        "metadata": {
                "status": [], (1)
                "datafiles": [], (2)
                "pagination": { (3)
                        "pageSize": 50,
                        "currentPage": 0,
                        "totalCount": 28,
                        "totalPages": 1
                }
        },
        "result": (4)
                ["banana", "barley", "beans", "breadfruit", "cassava", "chickpea", "coconut", "cowpea", "potato", "fababean", "fingermillet", "grasspea", "lentil", "maize", "pearlmillet", "pigeonpea", "rice", "sorghum", "sweetpotato", "taro", "wheat", "yam", "sunflower", "tomato", "eggplant", "lettuce", "apple", "forages"]
}
1 Request status
2 Data files generated by the request
3 Pagination data
4 Result

Unresolved directive in brapi/crops.adoc - include::/builds/genesys-pgr/genesys-server/build/generated-snippets/brapi-crops/response-fields.adoc[]

3. Germplasm

/brapi/v1/germplasm-search endpoint allows for retrieving accession data from Genesys.

Unresolved directive in brapi/germplasm.adoc - include::/builds/genesys-pgr/genesys-server/build/generated-snippets/brapi-germplasm-search/curl-request.adoc[]

3.1.1. Request parameters

Unresolved directive in brapi/germplasm.adoc - include::/builds/genesys-pgr/genesys-server/build/generated-snippets/brapi-germplasm-search/request-parameters.adoc[]

3.1.2. Server response

Genesys returns the standard BrAPI Germplasm response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
{
        "metadata": {
                "status": [],
                "datafiles": [],
                "pagination": {
                        "pageSize": 2,
                        "currentPage": 2,
                        "totalCount": 3637680,
                        "totalPages": 1818840
                }
        },
        "result": <1> [{
                "defaultDisplayName": "DJUG 16",
                "germplasmPUI": "10.0000/ABCD*",
                "pedigree": null,
                "seedSource": null,
                "synonyms": ["DJUG 16"],
                "commonCropName": null,
                "genus": "Juglans",
                "species": "californica",
                "subtaxa": null,
                "subtAuthor": null,
                "germplasmDbId": "ac5d4de4-dc7d-487b-b11f-b4b4c8b7c045",
                "accessionNumber": "DJUG 16",
                "germplasmName": "DJUG 16",
                "instituteCode": "USA390",
                "instituteName": "Botany Department, University of California",
                "biologicalStatusOfAccessionCode": 999,
                "countryOfOriginCode": "USA",
                "typeOfGermplasmStorageCode": [],
                "speciesAuthority": null,
                "acquisitionDate": "19830923"
        }, {
                "defaultDisplayName": "NSL 18",
                "germplasmPUI": null,
                "pedigree": null,
                "seedSource": null,
                "synonyms": ["PIRA NARANJA", "NSL 18", "PIRA NARANJA"],
                "commonCropName": "maize",
                "genus": "Zea",
                "species": "mays",
                "subtaxa": "subsp. mays",
                "subtAuthor": null,
                "germplasmDbId": "86131120-782b-4108-afde-82de3ae008a4",
                "accessionNumber": "NSL 18",
                "germplasmName": "NSL 18",
                "instituteCode": "USA020",
                "instituteName": "North Central Regional Plant Introduction Station, USDA-ARS, NCRPIS",
                "biologicalStatusOfAccessionCode": 300,
                "countryOfOriginCode": null,
                "typeOfGermplasmStorageCode": [],
                "speciesAuthority": "L.",
                "acquisitionDate": "195905--"
        }]
}
1 Array containing matching Germplasm records

Unresolved directive in brapi/germplasm.adoc - include::/builds/genesys-pgr/genesys-server/build/generated-snippets/brapi-germplasm-search/response-fields.adoc[]

3.2. Germplasm by ID

/brapi/v1/germplasm/{germplasmID} endpoint allows for retrieving accession data from Genesys.

Unresolved directive in brapi/germplasm.adoc - include::/builds/genesys-pgr/genesys-server/build/generated-snippets/brapi-germplasm/curl-request.adoc[]

3.2.1. Path parameters

Unresolved directive in brapi/germplasm.adoc - include::/builds/genesys-pgr/genesys-server/build/generated-snippets/brapi-germplasm/path-parameters.adoc[]

3.2.2. Server response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
{
        "metadata": {
                "status": [],
                "datafiles": [],
                "pagination": {
                        "pageSize": 0,
                        "currentPage": 0,
                        "totalCount": 0,
                        "totalPages": 0
                }
        },
        "result": {
                "defaultDisplayName": "TCc-8104",
                "germplasmPUI": null,
                "pedigree": null,
                "seedSource": null,
                "synonyms": null,
                "commonCropName": "pigeonpea",
                "genus": "Cajanus",
                "species": "cajan",
                "subtaxa": null,
                "subtAuthor": null,
                "germplasmDbId": "cd8c1217-4503-4859-813b-32251f0c8eba",
                "accessionNumber": "TCc-8104",
                "germplasmName": "TCc-8104",
                "instituteCode": "NGA039",
                "instituteName": "International Institute of Tropical Agriculture",
                "biologicalStatusOfAccessionCode": null,
                "countryOfOriginCode": "SLE",
                "typeOfGermplasmStorageCode": [],
                "speciesAuthority": null,
                "acquisitionDate": null
        }
}

Unresolved directive in brapi/germplasm.adoc - include::/builds/genesys-pgr/genesys-server/build/generated-snippets/brapi-germplasm/response-fields.adoc[]