Open nestorjal opened 8 years ago
In this moment is impossible registry our app in CITES API, I sent an email asking for help because the problem is that our organisation is not present in CITES organisations list.
CITES response "Thank you for your email. Organisations do not need to be registered with the system, those shown are simply those that have already been entered. To add a new organisation, please type the name of your organisation, hit enter and then continue with registration." then I going to continue with this issue.
CITES API has different calls and each one returns different information, for example:
api/v1/taxon_concepts returns
{ "pagination":{ "current_page":1, "per_page":500, "total_entries":1 }, "taxon_concepts":[ { "id":4521, "full_name":"Loxodonta africana", "author_year":"(Blumenbach, 1797)", "rank":"SPECIES", "name_status":"A", "updated_at":"2014-12-11T15:39:51.620Z", "active":true, "cites_listing":"I/II", "higher_taxa":{ "kingdom":"Animalia", "phylum":"Chordata", "class":"Mammalia", "order":"Proboscidea", "family":"Elephantidae" }, "synonyms":[ { "id":37069, "full_name":"Loxodonta cyclotis", "author_year":"(Matschie, 1900)", "rank":"SPECIES" } ], "common_names":[ { "name":"African Elephant", "language":"EN" }, { "name":"African Savannah Elephant", "language":"EN" }, { "name":"Eléphant d'Afrique", "language":"FR" }, { "name":"Eléphant africain", "language":"FR" } ], "cites_listings":[ { "appendix":"II", "annotation":"The populations of Botswana, Namibia, South Africa and Zimbabwe are listed in Appendix II for the exclusive purpose of allowing: [...]", "hash_annotation":null }, { "appendix":"I", "annotation":"Included in Appendix I, except the populations of Botswana, Namibia, South Africa and Zimbabwe, which are included in Appendix II.", "hash_annotation":null } ] } ] }
with taxon_concepts.id we can use the following API calls:
api/v1/taxon_concepts/:taxon_concept_id/cites_legislation
{ "cites_listings":[ { "taxon_concept_id":4521, "is_current":true, "appendix":"II", "change_type":"+", "effective_at":"2007-09-13", "annotation":"The populations of Botswana, Namibia, South Africa and Zimbabwe are listed in Appendix II for the exclusive purpose of allowing: [...]" }, { "taxon_concept_id":4521, "is_current":true, "appendix":"I", "change_type":"+", "effective_at":"2007-09-13", "annotation":"Included in Appendix I, except the populations of Botswana, Namibia, South Africa and Zimbabwe, which are included in Appendix II." }, { "taxon_concept_id":4521, "is_current":true, "appendix":"I", "change_type":"R+", "effective_at":"1990-01-18", "annotation":null, "party":{ "iso_code2":"MW", "name":"Malawi", "type":null } } ], "cites_quotas":[ { "taxon_concept_id":4521, "quota":180.0, "publication_date":"2014-03-14", "notes":"tusks as trophies from 90 animals", "url":null, "public_display":true, "is_current":true, "unit":null, "geo_entity":{ "iso_code2":"NA", "name":"Namibia", "type":"COUNTRY" } }, { "taxon_concept_id":4521, "quota":160.0, "publication_date":"2014-03-14", "notes":"tusks as trophies from 80 animals", "url":null, "public_display":true, "is_current":true, "unit":null, "geo_entity":{ "iso_code2":"CM", "name":"Cameroon", "type":"COUNTRY" } } ], "cites_suspensions":[ { "taxon_concept_id":null, "notes":"All commercial trade in specimens of CITES-listed species.", "start_date":"2004-07-30", "is_current":true, "applies_to_import":false, "geo_entity":{ "iso_code2":"SO", "name":"Somalia", "type":"COUNTRY" }, "start_notification":{ "name":"CITES Notif. No. 2004/055", "date":"2004-07-30", "url":"http://www.cites.org/eng/notif/2004/055.pdf" } }, { "taxon_concept_id":4521, "notes":"The United States has suspended imports of sport-hunted trophies of African elephant taken in Zimbabwe on or after 4 April 2014.", "start_date":"2014-08-11", "is_current":true, "applies_to_import":false, "geo_entity":{ "iso_code2":"ZW", "name":"Zimbabwe", "type":"COUNTRY" }, "start_notification":{ "name":"CITES Notif. No. 2014/037", "date":"2014-08-11", "url":"http://cites.org/sites/default/files/notif/E-Notif-2014-037.pdf" } } ] }
api/v1/taxon_concepts/:taxon_concept_id/distributions
[ { "iso_code2":"GQ", "name":"Equatorial Guinea", "type":"COUNTRY", "references":[ "Basilio, A. 1962. La vida animal en la Guinea Espanola. Instituto de Estudios Africanos. Madrid." ] }, { "iso_code2":"MR", "name":"Mauritania", "type":"COUNTRY", "references":[ "Blanc, J.J., Thouless, C.R., Hart, J.A., Dublin H.T., Douglas-Hamilton, I., Craig, C.R. and Barnes, R.F.W. 2003. African Elephant Status Report 2002: an update from the African Elephant Database. http://iucn.org/afesg/aed/aesr2002.html IUCN/SSC African Elephant Specialist Group. IUCN, Gland, Switzerland and Cambridge, UK. ", "Jackson, P. 1982. Elephants and rhinos in Africa. A time for decision. IUCN. Gland." ] } ]
api/v1/taxon_concepts/:taxon_concept_id/references
[ { "citation":"Wilson, D.E. and Reeder, D.M. (Eds.) 1993. <i>Mammal species of the world, a taxonomic and geographic reference</i>. Smithsonian Institution Press. Washington and London.", "is_standard":true }, { "citation":"Wilson, D.E. and Reeder, D.M. (Eds.) 2005. <i>Mammal species of the world, a taxonomic and geographic reference</i>. The Johns Hopkins University Press.", "is_standard":false } ]
Although the editor currently has a PliC element for CITES, it will be useful an integration with the CITES API.