{
"garden_bed": [
"Tomato"
],
"best_companions": [
{
"name": "Asparagus",
"helps": [
"Basil",
"Calendula",
"Cilantro",
"Dill",
"Marigold",
"Oregano",
"Parsley",
"Petunia",
"Tomato"
],
"helped_by": [
"Basil",
"Lettuce",
"Petunia",
"Tomato"
],
"help_to_repel": [],
"avoid": [
"Broccoli",
"Garlic",
"Onion",
"Potato"
]
},
{
"name": "Basil",
"helps": [
"Asparagus",
"Lettuce",
"Oregano",
"Pepper",
"Tomato"
],
"helped_by": [
"Asparagus",
"Broccoli",
"Brussels Sprout",
"Lettuce",
"Pepper",
"Potato",
"Tomato"
],
"help_to_repel": [
"Aphid",
"Fly",
"Mosquito",
"Tomato Hornworm"
],
"avoid": [
"Rue",
"Sage",
"Thyme"
]
},
{
"name": "Bean",
"helps": [
"Beet",
"Broccoli",
"Brussels Sprout",
"Cabbage",
"Carrot",
"Catnip",
"Cauliflower",
"Celery",
"Corn",
"Cucumber",
"Eggplant",
"Kale",
"Marigold",
"Nasturtium",
"Pea",
"Potato",
"Radish",
"Rosemary",
"Squash",
"Strawberry",
"Summer Savory",
"Sunflower",
"Tomato"
],
"helped_by": [
"Beet",
"Brussels Sprout",
"Cabbage",
"Carrot",
"Cauliflower",
"Celery",
"Corn",
"Cucumber",
"Eggplant",
"Kale",
"Larkspur",
"Lettuce",
"Nasturtium",
"Pea",
"Pepper",
"Potato",
"Pumpkin",
"Radish",
"Spinach",
"Squash",
"Strawberry",
"Swiss Chard"
],
"help_to_repel": [],
"avoid": [
"Beet",
"Broccoli",
"Brussels Sprout",
"Cabbage",
"Chive",
"Fennel",
"Garlic",
"Gladiolus",
"Kohlrabi",
"Leek",
"Onion",
"Pepper",
"Shallot"
]
},
{
"name": "Bee Balm",
"helps": [
"Tomato"
],
"helped_by": [],
"help_to_repel": [],
"avoid": []
},
{
"name": "Carrot",
"helps": [
"Bean",
"Chive",
"Leek",
"Lettuce",
"Onion",
"Pea",
"Pepper",
"Radish",
"Rosemary",
"Sage",
"Tomato"
],
"helped_by": [
"Bean",
"Brussels Sprout",
"Garlic",
"Leek",
"Lettuce",
"Onion",
"Pea",
"Pepper",
"Radish",
"Tomato"
],
"help_to_repel": [],
"avoid": [
"Celery",
"Dill",
"Parsnip",
"Potato"
]
},
{
"name": "Celery",
"helps": [
"Bean",
"Broccoli",
"Brussels Sprout",
"Cabbage",
"Cauliflower",
"Kale",
"Kohlrabi",
"Leek",
"Onion",
"Tomato"
],
"helped_by": [
"Bean",
"Broccoli",
"Cabbage",
"Cauliflower",
"Kale",
"Leek",
"Pea",
"Spinach",
"Tomato"
],
"help_to_repel": [],
"avoid": [
"Carrot",
"Corn",
"Lettuce",
"Parsnip",
"Potato"
]
},
{
"name": "Garlic",
"helps": [
"Beet",
"Broccoli",
"Cabbage",
"Carrot",
"Cauliflower",
"Dill",
"Eggplant",
"Kohlrabi",
"Lettuce",
"Pepper",
"Potato",
"Rose",
"Spinach",
"Strawberry",
"Tomato"
],
"helped_by": [
"Beet",
"Broccoli",
"Brussels Sprout",
"Cabbage",
"Kale",
"Lettuce",
"Marigold",
"Pansy",
"Parsnip",
"Pepper",
"Potato",
"Rose",
"Strawberry",
"Tomato"
],
"help_to_repel": [
"Aphid",
"Beetle",
"Root Maggot"
],
"avoid": [
"Asparagus",
"Bean",
"Parsley",
"Pea",
"Sage"
]
},
{
"name": "Lettuce",
"helps": [
"Asparagus",
"Basil",
"Bean",
"Beet",
"Broccoli",
"Brussels Sprout",
"Carrot",
"Chive",
"Corn",
"Cucumber",
"Eggplant",
"Garlic",
"Mint",
"Onion",
"Pea",
"Radish",
"Spinach",
"Strawberry",
"Tomato"
],
"helped_by": [
"Alyssum",
"Basil",
"Beet",
"Broccoli",
"Carrot",
"Cucumber",
"Garlic",
"Kale",
"Lupin",
"Onion",
"Pea",
"Pepper",
"Phacelia",
"Potato",
"Radish",
"Spinach",
"Strawberry",
"Tomato"
],
"help_to_repel": [],
"avoid": [
"Cabbage",
"Celery",
"Parsley",
"Parsnip"
]
},
{
"name": "Marigold",
"helps": [
"Broccoli",
"Brussels Sprout",
"Cabbage",
"Cauliflower",
"Chive",
"Cucumber",
"Garlic",
"Kale",
"Kohlrabi",
"Leek",
"Melon",
"Onion",
"Pepper",
"Potato",
"Pumpkin",
"Rose",
"Shallot",
"Squash",
"Tomato",
"Zucchini"
],
"helped_by": [
"Asparagus",
"Bean",
"Broccoli",
"Cucumber",
"Eggplant",
"Potato",
"Pumpkin",
"Rose",
"Squash",
"Tomato"
],
"help_to_repel": [
"Aphid",
"Beet Leafhopper",
"Beetle",
"Cabbage Root Fly",
"Cucumber Beetle",
"Onion Fly",
"Root-Knot Nematode",
"Slug",
"Snail",
"Squash Bug",
"Whitefly"
],
"avoid": []
},
{
"name": "Nasturtium",
"helps": [
"Apple",
"Bean",
"Broccoli",
"Brussels Sprout",
"Cabbage",
"Cauliflower",
"Cucumber",
"Grape",
"Kale",
"Kohlrabi",
"Radish",
"Raspberry",
"Squash",
"Tomato"
],
"helped_by": [
"Bean",
"Broccoli",
"Brussels Sprout"
]
}
],
"_note": "Response truncated for documentation purposes"
}
curl --location --request POST 'https://zylalabs.com/api/13645/plant+pair+api/30945/find+companion+plants' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"garden_bed": [
"Tomato"
]
}'
{
"compatible": true,
"garden_bed": [
"string",
"string"
]
}
curl --location --request POST 'https://zylalabs.com/api/13645/plant+pair+api/30946/check+garden+bed+compatibility?extensive=true' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"garden_bed": [
"Tomato"
]
}'
{
"status": "ok"
}
curl --location --request GET 'https://zylalabs.com/api/13645/plant+pair+api/30947/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Par de Plantas API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
O endpoint POST Encontrar plantas companheiras retorna listas de plantas compatíveis para um canteiro de jardim específico, incluindo os melhores companheiros e plantas possíveis O endpoint POST Verificar compatibilidade do canteiro de jardim retorna um booleano indicando se as plantas especificadas podem compartilhar um canteiro O endpoint GET Verificação de saúde retorna uma mensagem de status simples indicando a disponibilidade do serviço
Os campos principais na resposta POST Encontrar plantas companheiras incluem "cama_jardim", "melhores_companheiros" e "possível_plantar" Para a compatibilidade da cama de jardim POST Verificar, o campo principal é "compatível" A resposta GET Verificação de saúde contém o campo "status"
Os dados da resposta estão estruturados no formato JSON Para plantas companheiras inclui arrays para "melhores_companheiros" e "possível_plantar" cada um contendo objetos com nomes das plantas e seus detalhes de compatibilidade A verificação de compatibilidade retorna um valor booleano simples enquanto a verificação de saúde retorna uma mensagem de status
Os endpoints POST Find companion plants e POST Check garden bed compatibility requerem um parâmetro "garden_bed" contendo um ou mais nomes de plantas O parâmetro "extensive" pode ser usado para modificar a resposta para resultados mais detalhados Nomes inválidos ou menos de dois nomes resultarão em um erro 400
O endpoint POST Encontrar plantas companheiras fornece informações sobre plantas compatíveis, incluindo aquelas que ajudam ou são ajudadas por outras O endpoint POST Verificar compatibilidade de canteiros indica se as plantas especificadas podem coexistir O endpoint GET Verificação de saúde confirma o status operacional da API
A precisão dos dados é mantida por meio de um mapeamento de nomes comuns e de cultivares para catalogar plantas garantindo identificação consistente A API também lida com nomes desconhecidos e fornece correspondências aproximadas ajudando os usuários a encontrar plantas relevantes mesmo se inserirem nomes ligeiramente incorretos
Casos de uso típicos incluem jardineiros que buscam otimizar arranjos de plantas para melhor crescimento e controle de pragas, assim como hobbyistas que desejam explorar a compatibilidade de plantas. Os usuários também podem utilizar a verificação de saúde para garantir que a API está operacional antes de fazer solicitações
Se o parâmetro garden_bed estiver vazio ou contiver nomes desconhecidos, a API retorna um erro 400. Os usuários devem garantir que nomes de plantas válidos sejam fornecidos. Para resultados parciais, como quando algumas plantas são compatíveis e outras não, a API ainda retornará as plantas compatíveis, permitindo que os usuários ajustem suas seleções de acordo