This library adds support for the PlantBook API. See https://plantbook.io for more info.
You will need to create a account on https://open.plantbook.io and generate a ClientId and Secret.
Searching for plants:
var plantbook = new PlantBook(new("auth client id", "auth secret"));
var searchResult = await plantbook.SearchAsync("pancake");
Console.WriteLine(searchResult.Results[0].DisplayPid);
// Output:
// Pilea peperomioidesGet more info about a plant:
var plantbook = new PlantBook(new("auth client id", "auth secret"));
var plant = await plantbook.GetAsync("pilea peperomioides");
Console.WriteLine(plant.Alias);
Console.WriteLine(plant.MinTemp);
Console.WriteLine(plant.ImageUrl);
// Output:
// pancake plant
// 10
// https://opb-img.plantbook.io/pilea%20peperomioides.jpgpublic interface IPlantBook
{
/// <summary>
/// Create new user plant or modify public plant
/// </summary>
/// <param name="plant"><display_pid>: Scientific name of the plant. Based on this attribute <pid> (Plant ID) attribute will be automatically generated by lowering case of this attribute.
/// E.g: <display_pid>="Tomato Red" will result in <pid>="tomato red"</param>
Task<Plant> CreateAsync(Plant plant, CancellationToken cancellationToken = default);
/// <summary>
/// Delete plant from user-plants. Public-plants cannot be removed.
/// </summary>
Task DeleteAsync(string pid, CancellationToken cancellationToken = default);
/// <summary>
/// Retrieve plant details using "pid" (Plant ID)
/// </summary>
Task<Plant> GetDetailsAsync(string pid, CancellationToken cancellationToken = default);
/// <summary>
/// Search any occurrences of text in "display_pid" and "alias" fields.
/// </summary>
/// <param name="alias">search string - MINIMUM LENGHT is 3 characters</param>
/// <param name="userplant">true - search and return only user-plants, false - search and return only public-plants, if omitted - combined search across user and public plants</param>
Task<SearchResult> SearchAsync(string alias, int? offset = null, int? limit = null, bool? userplant = null, CancellationToken cancellationToken = default);
/// <summary>
/// Method updates either user-plant or public-plant using JSON payload. User-plant is attempted to update first. If user-plant not found then API searches 'pid' in public-plants. If found in public-plants then the public plant will be cloned and saved as user-plant with requested changes.
/// </summary>
Task<Plant> UpdateAsync(Plant plant, CancellationToken cancellationToken = default);
}