Investigate Worms and TaxonWorks APIs & Develop Exporter

[dimasciput]

To facilitate the import and synchronization of taxonomic data into FADAtims, we need to first investigate the APIs of Worms and TaxonWorks. This will help us understand the data structure, endpoints, and authentication requirements. Additionally, we need to develop an initial exporter that extracts relevant taxonomic lists in a structured format.

[dimasciput]

I have managed to install taxonworks and add some sample data. Here are taxon name testing data :

{'id': 1, 'name': 'Root', 'parent_id': None, 'cached': 'Root', 'cached_html': 'Root', 'feminine_name': None, 'masculine_name': None, 'nomenclatural_code': None, 'neuter_name': None, 'etymology': None, 'year_of_publication': None, 'verbatim_author': None, 'rank': 'nomenclatural rank', 'rank_string': 'NomenclaturalRank', 'type': 'Protonym', 'created_by_id': 1, 'updated_by_id': 1, 'project_id': 1, 'cached_valid_taxon_name_id': 1, 'cached_original_combination': None, 'cached_original_combination_html': None, 'cached_author_year': None, 'cached_secondary_homonym': None, 'cached_primary_homonym': 'Root', 'cached_is_valid': True, 'created_at': '2025-01-20T16:03:06.717Z', 'updated_at': '2025-01-20T16:03:06.717Z', 'verbatim_name': None, 'year': None, 'name_string': 'Root', 'original_combination': None}
{'id': 2, 'name': 'Plantae', 'parent_id': 1, 'cached': 'Plantae', 'cached_html': 'Plantae', 'feminine_name': None, 'masculine_name': None, 'nomenclatural_code': 'icn', 'neuter_name': None, 'etymology': None, 'year_of_publication': None, 'verbatim_author': None, 'rank': 'kingdom', 'rank_string': 'NomenclaturalRank::Icn::HigherClassificationGroup::Kingdom', 'type': 'Protonym', 'created_by_id': 1, 'updated_by_id': 1, 'project_id': 1, 'cached_valid_taxon_name_id': 2, 'cached_original_combination': None, 'cached_original_combination_html': None, 'cached_author_year': None, 'cached_secondary_homonym': None, 'cached_primary_homonym': 'Plantae', 'cached_is_valid': True, 'created_at': '2025-01-20T16:19:15.404Z', 'updated_at': '2025-01-20T16:19:15.404Z', 'verbatim_name': None, 'year': None, 'name_string': 'Plantae', 'original_combination': None}
{'id': 3, 'name': 'Charophyta', 'parent_id': 2, 'cached': 'Charophyta', 'cached_html': 'Charophyta', 'feminine_name': None, 'masculine_name': None, 'nomenclatural_code': 'icn', 'neuter_name': None, 'etymology': None, 'year_of_publication': None, 'verbatim_author': None, 'rank': 'phylum', 'rank_string': 'NomenclaturalRank::Icn::HigherClassificationGroup::Phylum', 'type': 'Protonym', 'created_by_id': 1, 'updated_by_id': 1, 'project_id': 1, 'cached_valid_taxon_name_id': 3, 'cached_original_combination': None, 'cached_original_combination_html': None, 'cached_author_year': None, 'cached_secondary_homonym': None, 'cached_primary_homonym': 'Charophyta', 'cached_is_valid': True, 'created_at': '2025-01-20T16:20:26.187Z', 'updated_at': '2025-01-20T16:20:26.187Z', 'verbatim_name': None, 'year': None, 'name_string': 'Charophyta', 'original_combination': None}
{'id': 4, 'name': 'Charophyceae', 'parent_id': 3, 'cached': 'Charophyceae', 'cached_html': 'Charophyceae', 'feminine_name': None, 'masculine_name': None, 'nomenclatural_code': 'icn', 'neuter_name': None, 'etymology': None, 'year_of_publication': None, 'verbatim_author': None, 'rank': 'class', 'rank_string': 'NomenclaturalRank::Icn::HigherClassificationGroup::ClassRank', 'type': 'Protonym', 'created_by_id': 1, 'updated_by_id': 1, 'project_id': 1, 'cached_valid_taxon_name_id': 4, 'cached_original_combination': None, 'cached_original_combination_html': None, 'cached_author_year': None, 'cached_secondary_homonym': None, 'cached_primary_homonym': 'Charophyceae', 'cached_is_valid': True, 'created_at': '2025-01-20T16:24:54.095Z', 'updated_at': '2025-01-20T16:24:54.095Z', 'verbatim_name': None, 'year': 2016, 'name_string': 'Charophyceae', 'original_combination': None}
{'id': 5, 'name': 'Charales', 'parent_id': 4, 'cached': 'Charales', 'cached_html': 'Charales', 'feminine_name': None, 'masculine_name': None, 'nomenclatural_code': 'icn', 'neuter_name': None, 'etymology': None, 'year_of_publication': None, 'verbatim_author': None, 'rank': 'order', 'rank_string': 'NomenclaturalRank::Icn::HigherClassificationGroup::Order', 'type': 'Protonym', 'created_by_id': 1, 'updated_by_id': 1, 'project_id': 1, 'cached_valid_taxon_name_id': 5, 'cached_original_combination': None, 'cached_original_combination_html': None, 'cached_author_year': None, 'cached_secondary_homonym': None, 'cached_primary_homonym': 'Charales', 'cached_is_valid': True, 'created_at': '2025-01-20T16:25:36.753Z', 'updated_at': '2025-01-20T16:25:36.753Z', 'verbatim_name': None, 'year': None, 'name_string': 'Charales', 'original_combination': None}
{'id': 6, 'name': 'Characeae', 'parent_id': 5, 'cached': 'Characeae', 'cached_html': 'Characeae', 'feminine_name': None, 'masculine_name': None, 'nomenclatural_code': 'icn', 'neuter_name': None, 'etymology': None, 'year_of_publication': None, 'verbatim_author': None, 'rank': 'family', 'rank_string': 'NomenclaturalRank::Icn::FamilyGroup::Family', 'type': 'Protonym', 'created_by_id': 1, 'updated_by_id': 1, 'project_id': 1, 'cached_valid_taxon_name_id': 6, 'cached_original_combination': None, 'cached_original_combination_html': None, 'cached_author_year': None, 'cached_secondary_homonym': None, 'cached_primary_homonym': 'Characeae', 'cached_is_valid': True, 'created_at': '2025-01-20T16:26:18.732Z', 'updated_at': '2025-01-20T16:26:18.732Z', 'verbatim_name': None, 'year': 2016, 'name_string': 'Characeae', 'original_combination': None}
{'id': 7, 'name': 'Chara', 'parent_id': 6, 'cached': 'Chara', 'cached_html': '<i>Chara</i>', 'feminine_name': None, 'masculine_name': None, 'nomenclatural_code': 'icn', 'neuter_name': None, 'etymology': None, 'year_of_publication': 1753, 'verbatim_author': None, 'rank': 'genus', 'rank_string': 'NomenclaturalRank::Icn::GenusGroup::Genus', 'type': 'Protonym', 'created_by_id': 1, 'updated_by_id': 1, 'project_id': 1, 'cached_valid_taxon_name_id': 7, 'cached_original_combination': None, 'cached_original_combination_html': None, 'cached_author_year': 'Linnaeus', 'cached_secondary_homonym': None, 'cached_primary_homonym': 'Chara', 'cached_is_valid': True, 'created_at': '2025-01-20T16:29:30.661Z', 'updated_at': '2025-01-20T16:29:30.661Z', 'verbatim_name': None, 'year': 1753, 'name_string': 'Chara Linnaeus', 'original_combination': None}
{'id': 8, 'name': 'Aspera', 'parent_id': 7, 'cached': 'Chara Aspera', 'cached_html': '<i>Chara Aspera</i>', 'feminine_name': None, 'masculine_name': None, 'nomenclatural_code': 'icn', 'neuter_name': None, 'etymology': None, 'year_of_publication': None, 'verbatim_author': None, 'rank': 'species', 'rank_string': 'NomenclaturalRank::Icn::SpeciesAndInfraspeciesGroup::Species', 'type': 'Protonym', 'created_by_id': 1, 'updated_by_id': 1, 'project_id': 1, 'cached_valid_taxon_name_id': 8, 'cached_original_combination': None, 'cached_original_combination_html': None, 'cached_author_year': 'Willd', 'cached_secondary_homonym': 'Chara Aspera', 'cached_primary_homonym': None, 'cached_is_valid': True, 'created_at': '2025-01-20T16:31:36.812Z', 'updated_at': '2025-01-20T16:31:36.812Z', 'verbatim_name': None, 'year': None, 'name_string': 'Chara Aspera Willd', 'original_combination': None}