JSON API (beta) :: Breeder/Strain-IDs
Our JSON-based API provides an interface for client developers to interact with content stored on SeedFinder, and to build new applications on top of SeedFinder's infrastructure. The JSON-Files you can get and use very simple with a URL GET or POST request and a little bit JavaScript, PHP or something like that.
Please note:
To use our JSON API you must verify your domain(s) here into the User-Area at first!
If you do a request from a unregistered domain you will get an Error 403!
Parameters for the request
The standard-request without parameters will deliver all breeder-ids (including logo and the name) without adding the strain-ids. Additionally you can add the strains for every selected breeder if you set the parameter strains=1. If you dont need info about all breeders use the br-parameter to limit the breeder-output to the selected ones.
| Parameter | Example | Description |
|---|---|---|
| br | ?br=Sensi_Seeds ?br=Sensi_Seeds|Dutch_Passion ?br=all | Selection of breeders. Add all to get a full list, or add the SeedFinder-Breeder-IDs for one ore more breeders. To get info about more than one breeder, seperate the ids with a "|". Preset is all. |
| strains | &strains=1 | Will add strain-ids and strain-names to the output. |
| output | &output=1 &output=2 | Alternative output-types. Preset is 0 (pure JSON output) Click here to read more about the possible output formats. |
StrainInfo JSON: https://en.seedfinder.eu/api/json/ids.json
Example: https://en.seedfinder.eu/api/json/ids.json?br=Sensi_Seeds|Dutch_Passion&strains=1
The Response
A valid query returns a JSON file with an object which contains an own object for every breeder (named with the Seedfinder-Breeder-ID). An invalid request provides an object with an error message. Here is an overview of the possible content.
Object -> [breeder-id]
| Name | Value | Description |
|---|---|---|
| name | String | The name of the breeder. |
| logo | String | The logo of the breeder. Stored below: https://de.seedfinder.eu/pics/00breeder/ |
| strains | Object | Strain by this breeder. This Object will only be existent if strains=1! |
The object strains is only existent if the optional parameter strains=1 was added to the request-url. The object contains name/value pairs for every strain by the breeder, named with the Seedfinder-Strain-ID and with the strain-name as value.
Object -> [breeder-id] -> strains
| Value | Description |
|---|---|
| String | Name of the Strain |
Example
The Request https://de.seedfinder.eu/api/json/ids.json?br=Serious_Seeds|Cannabiogen&strains=1 will deliver a JSON like this:
{"Serious_Seeds": {
"name": "Serious Seeds",
"logo": "serious.gif",
"strains": {
"AK47": "AK47",
"Bubble_Gum": "Bubble Gum",
"Chronic": "Chronic",
"Kali_Mist": "Kali Mist",
"White_Russian": "White Russian"
}
},
"Cannabiogen": {
"name": "Cannabiogen",
"logo": "cannabiogen.jpg",
"strains": {
"Caribe": "Caribe",
"Destroyer": "Destroyer",
"Leshaze": "Leshaze",
"Sand_Storm": "Sand Storm",
"Sugar_Loaf": "Sugar Loaf",
"Taskenti": "Taskenti"
}
}
}
Test it
We prepared a small test-widget for you. This example is full working and you can add it very easy to your page. This widget uses the StrainSearch API, the Strain/Breeder-ID API and also the StrainInfo-API to create a complete strain-browser with search-function for your page. Here you will find it. (open in a new window)
WICHTIG
Bitte beachten: Um unsere JSON API zu nutzen musst du zuvor hier im User-Bereich deine Domain(s) verifizieren!
Kommt die Abfrage von einer unregistrierten Domain wird ein Error 403 ausgeliefert!
Mit Hilfe der SeedFinder API bist du in der Lage unsere Daten für deine eigenen Applikationen und Widgets zu benutzen und kannst unsere Informationen direkt in deine Homepage einbinden. Das Ganze ist im Rahmen unserer Lizenz völlig kostenlos, wir behalten uns aber das Recht vor, bei zu enormen Traffic oder sonstigem ausfallendem Verhalten den Zugriff zu beschränken oder zu blocken. Um informiert zu bleiben wirf bitte ein Auge auf unseren Newsflash und/oder verknüpfe eine Email-Adresse mit deinem User-Account, damit wir dich im Zweifel erreichen können. Falls du keine Links zu uns setzen möchtest, oder eine kommerzielle Seite betreibst, melde dich bitte vorher bei uns.
»» Alle Daten stehen unter einer Creative Commons BY-NC-SA 3.0 Lizenz
