Openbare data voor ontwikkelaars

Bouw verder op MakerIndex.

Lees actuele gegevens over makerspaces en machines als JSON. De openbare API is gratis, gebruikt alleen GET en vraagt niet om een account of sleutel.

Bekijk labs als JSON →Bekijk alle routes ↓

makerindex.org

GET/api/labs?page=1&page_size=20

HTTP 200
Content-Type: application/vnd.api+json

{
  "jsonapi": { "version": "1.0" },
  "meta": { "total": 32, "page": 1 },
  "data": [ ... ]
}

01Vrij toegankelijk

Geen account, token of registratie nodig.

02Alleen lezen

De openbare routes ondersteunen uitsluitend GET.

03Voorspelbaar JSON

Resources, relaties en links volgen de vorm van JSON:API.

Routes

Zes ingangen tot de catalogus

Vervang {id} door het ID van een makerspace of machine. Alle routes beginnen met https://makerindex.org.

01GET

/api/labs

Een lijst met openbare en actieve makerspaces.

Vergelijk met FabLabs.io ↗

02GET

/api/labs/{id}

Eén makerspace op basis van het numerieke ID.

Vergelijk met FabLabs.io ↗

03GET

/api/labs/search?q={zoekterm}

Zoeken in naam, plaats, beschrijving en faciliteiten.

Vergelijk met FabLabs.io ↗

04GET

/api/labs/{id}/relationships/machines

De gepubliceerde machines van één makerspace.

Vergelijk met FabLabs.io ↗

05GET

/api/machines

Een lijst met alle gepubliceerde machines.

Vergelijk met FabLabs.io ↗

06GET

/api/machines/{id}

Eén machine op basis van het numerieke ID.

Vergelijk met FabLabs.io ↗

Parameters

Verfijn het antwoord

page

Paginanummer vanaf 1. De standaardwaarde is 1.

page_size

Aantal resultaten per pagina, van 1 tot en met 100. De standaardwaarde is 20.

q

Zoekt zonder onderscheid tussen hoofdletters en kleine letters. Werkt voor makerspaces en machines.

sort

Sorteert makerspaces op name, city of created_at.

sort_order

Gebruik asc of desc. De standaardwaarde is asc.

Voorbeeldcurl 'https://makerindex.org/api/labs/search?q=laser&page_size=10'

Antwoord

Vaste structuur, duidelijke navigatie

Een collectie bevat resources in data, paginagegevens in meta en links naar andere pagina’s in links. De IDs worden als tekenreeks teruggegeven.

200De aanvraag is geslaagd.

404Het ID bestaat niet of de resource is niet openbaar.

{
  "jsonapi": { "version": "1.0" },
  "meta": {
    "total": 32,
    "page": 1,
    "page_size": 20
  },
  "links": {
    "self": "https://makerindex.org/api/labs?page=1&page_size=20",
    "first": "https://makerindex.org/api/labs?page=1&page_size=20",
    "last": "https://makerindex.org/api/labs?page=2&page_size=20",
    "prev": null,
    "next": "https://makerindex.org/api/labs?page=2&page_size=20"
  },
  "data": [
    {
      "type": "labs",
      "id": "12",
      "attributes": {
        "name": "Voorbeeld Makerspace",
        "city": "Utrecht"
      }
    }
  ]
}

Velden

Wat je kunt gebruiken

Een makerspace verwijst via relationships.machines naar de bijbehorende machines. Iedere machine verwijst via relationships.lab terug naar de makerspace.

Makerspaces19 attributen

nameslugcityaddresspostcodelatitudelongitudewebsitedescriptionprimary_typefacilitiesopening_hoursspecial_opening_hoursholiday_closuresaccess_infopublic_emaillast_verified_atcreated_atupdated_at

Machines16 attributen

namecategorydescriptionmaterialsmax_formatcostcourse_requiredown_materials_allowedmembers_onlyminimum_agesafety_equipmentpreparationnotesavailabilitycreated_atupdated_at

Herkomst en compatibiliteit

Gebaseerd op open standaarden

De routes zijn gebaseerd op de API referentie van FabLabs.io. De indeling van antwoorden volgt JSON:API versie 1.0.

MakerIndex heeft eigen velden en standaardwaarden en is daarom geen volledige vervanging voor FabLabs.io. Waar FabLabs.io OAuth beschrijft, hebben deze openbare MakerIndex routes geen inlog nodig.