fablabbcn/fablabs

View on GitHub
apiary.apib

Summary

Maintainability
Test Coverage
FORMAT: 1A
HOST: http://api.fablabs.io/

# Fablabs.io

Fablabs.io API.

We implement JSON API. For more information visit: http://jsonapi.org/.



## Labs Collection [/labs?{page}&{per}&{sort}]

### List All Labs [GET]

+ Parameters
    + page (int) - Page number for pagination
    + per (int) - Number of results per page
    + sort (string) - Sort by name ASC or DESC

+ Response 200 (application/json)

        { 
            "data":
                { 
                    "labs":
                        [   
                            {
                                "id": "142",
                                "type":"fab_lab",
                                "attributes":
                                    {
                                        "slug": "fablabbcn",
                                        "name": "Fab Lab BCN",
                                        "blurb": "Fab Lab Barcelona is a centre of production, investigation and education, that uses the latest computer-assisted design software for the creation of prototypes and scale models.","description":"Fab Lab Barcelona is a centre of production, investigation and education, that uses the latest computer-assisted design software for the creation of prototypes and scale models for Architecture, Construction and Industrial Design.",
                                        "location": 
                                            {
                                                "address_1":"Carrer de Pujades, 102",
                                                "address_2":"",
                                                "city":"Barcelona",
                                                "county":"Catalonia",
                                                "postal_code":"08005",
                                                "country_code":"es",
                                                "coordinates": 
                                                    {
                                                        "latitude":41.3965511,
                                                        "longitude":2.19416179999996,
                                                    },
                                                "address_notes":"",
                                            },
                                        "avatar":"https://www.filepicker.io/api/file/N2owmTJoSMOR2wousv66",
                                        "header_image_src":"https://www.filepicker.io/api/file/sJw7EBcTxSXYG5IrgWYg",
                                        "phone":"+34 93 3209520",
                                        "email":"info@fablabbcn.org",
                                        "capabilities":
                                            [
                                                "three_d_printing",
                                                "cnc_milling",
                                                "circuit_production",
                                                "laser",
                                                "precision_milling",
                                                "vinyl_cutting"
                                            ],
                                    },
                                 "links": 
                                    {
                                        "self": "https://api.fablabs.io/fablabbcn",
                                        "related": "http://fablab.fikket.com/",
                                        "media": "http://vimeo.com/fablabbcn/videos",
                                        "twitter": "http://twitter.com/fablabbcn",
                                        "github": "https://github.com/fablabbcn",
                                    },
                                "relationships":
                                    {
                                        "referees": 
                                            [
                                                {
                                                    "id":"123",
                                                    "type": "fab_lab",
                                                    "attributes": 
                                                        {
                                                            "name": "AS220",
                                                            "slug": "as220",
                                                        }
                                                },
                                            ]
                                    }
                            },
                        ]
                }
        }




## Search Labs [/labs/search?{country}&{country_code}&{lat}&{lon}&{city}&{query}&{points}&{ip}&{radius}&{referee}&{capabilities}&{tags}]

### Search Labs [GET]

+ Response 200 (application/json)

+ Parameters
    + country (string) - Fab lab country: ex. spain.
    + country_code (string) - Fab lab country code: ex. es.
    + lat (string) - Fab lab latitude.
    + lon (string) - Fab lab longitude.
    + city (string) - Fab lab city.
    + query (string) - Search labs by search query 
    + radius (string) - Spherical radius for geographical searches
    + points (array) - Array of geographical coordinates
    + ip (string) - IP address
    + referee (string) - Search lab by referee lab
    + capabilities (string) - Search lab by capabilities
    + tags (string) - Search lab by tags

+ Response 200 (application/json)

        { 
            "data":
                { 
                    "labs":
                        [   
                            {
                                "id": "142",
                                "type":"fab_lab",
                                "attributes":
                                    {
                                        "slug": "fablabbcn",
                                        "name": "Fab Lab BCN",
                                        "blurb": "Fab Lab Barcelona is a centre of production, investigation and education, that uses the latest computer-assisted design software for the creation of prototypes and scale models.","description":"Fab Lab Barcelona is a centre of production, investigation and education, that uses the latest computer-assisted design software for the creation of prototypes and scale models for Architecture, Construction and Industrial Design.",
                                        "location": 
                                            {
                                                "address_1":"Carrer de Pujades, 102",
                                                "address_2":"",
                                                "city":"Barcelona",
                                                "county":"Catalonia",
                                                "postal_code":"08005",
                                                "country_code":"es",
                                                "coordinates": 
                                                    {
                                                        "latitude":41.3965511,
                                                        "longitude":2.19416179999996,
                                                    },
                                                "address_notes":"",
                                            },
                                        "avatar":"https://www.filepicker.io/api/file/N2owmTJoSMOR2wousv66",
                                        "header_image_src":"https://www.filepicker.io/api/file/sJw7EBcTxSXYG5IrgWYg",
                                        "phone":"+34 93 3209520",
                                        "email":"info@fablabbcn.org",
                                        "capabilities":
                                            [
                                                "three_d_printing",
                                                "cnc_milling",
                                                "circuit_production",
                                                "laser",
                                                "precision_milling",
                                                "vinyl_cutting"
                                            ],
                                    },
                                 "links": 
                                    {
                                        "self": "https://api.fablabs.io/fablabbcn",
                                        "related": "http://fablab.fikket.com/",
                                        "media": "http://vimeo.com/fablabbcn/videos",
                                        "twitter": "http://twitter.com/fablabbcn",
                                        "github": "https://github.com/fablabbcn",
                                    },
                                "relationships":
                                    {
                                        "referees": 
                                            [
                                                {
                                                    "id":"123",
                                                    "type": "fab_lab",
                                                    "attributes": 
                                                        {
                                                            "name": "AS220",
                                                            "slug": "as220",
                                                        }
                                                },
                                            ]
                                    }
                            },
                        ]
                }
        }




## Lab [/labs/{lab_id}]

### Lab [GET]

+ Parameters
    + lab_id (string) - Fab lab unique id.

+ Response 200 (application/json)

        { 
            "data":
                { 
                    {
                        "id": "142",
                        "type":"fab_lab",
                        "attributes":
                            {
                                "slug": "fablabbcn",
                                "name": "Fab Lab BCN",
                                "blurb": "Fab Lab Barcelona is a centre of production, investigation and education, that uses the latest computer-assisted design software for the creation of prototypes and scale models.","description":"Fab Lab Barcelona is a centre of production, investigation and education, that uses the latest computer-assisted design software for the creation of prototypes and scale models for Architecture, Construction and Industrial Design.",
                                "location": 
                                    {
                                        "address_1":"Carrer de Pujades, 102",
                                        "address_2":"",
                                        "city":"Barcelona",
                                        "county":"Catalonia",
                                        "postal_code":"08005",
                                        "country_code":"es",
                                        "coordinates": 
                                            {
                                                "latitude":41.3965511,
                                                "longitude":2.19416179999996,
                                            },
                                        "address_notes":"",
                                    },
                                "avatar": "https://www.filepicker.io/api/file/N2owmTJoSMOR2wousv66",
                                "header_image_src": "https://www.filepicker.io/api/file/sJw7EBcTxSXYG5IrgWYg",
                                "phone": "+34 93 3209520",
                                "email": "info@fablabbcn.org",
                                "capabilities":
                                    [
                                        "three_d_printing",
                                        "cnc_milling",
                                        "circuit_production",
                                        "laser",
                                        "precision_milling",
                                        "vinyl_cutting"
                                    ],
                                "referees": 
                                    [
                                        {
                                            "id":"123",
                                            "type": "fab_lab",
                                            "attributes": 
                                                {
                                                    "name": "AS220",
                                                    "slug": "as220",
                                                }
                                        },
                                    ],
                            },
                        "links": 
                            {
                                "self": "https://api.fablabs.io/fablabbcn",
                                "related": "http://fablab.fikket.com/",
                                "media": "http://vimeo.com/fablabbcn/videos",
                                "twitter": "http://twitter.com/fablabbcn",
                                "github": "https://github.com/fablabbcn",
                            }
                    }
                }
        }

### Lab [POST]

+ Request

        { 
            "data":
                {
                    "authenticity_token": "l2yUnGCJ1r/1fFBrfWdfCdtZgni8IzMV2IBWEWXmWY8=",
                    "type": "fablab",
                    "id": "213",
                    "attributes": 
                        {
                            "name": "TestLab21",
                            "charter": 1,
                            "tools": 1,
                            "network": 1,
                            "programs": 1,
                            "public": 1,
                            "blurb": "This is a test fab lab.",
                            "description": "This is a test lab. Just ignore everything about it.",
                            "slug": "testlab21",
                            "location": 
                                {
                                    "geocomplete": "Carrer+de+la+Canuda,+45-47,+08002+Barcelona,+Barcelona,+Spain",
                                    "address_1": "Barcelona",
                                    "address_2": "Plaza+de+Catalunya",
                                    "city": "Barcelona",
                                    "postal_code": "08002",
                                    "country_code": "es",
                                    "coordinates": 
                                        {
                                            "latitude": "41.3850595",
                                            "longitude" : "2.173406699999987"
                                        }
                                },
                            "email": "email@fablabs.io"
                            "links": 
                                {
                                    "self": "https://api.fablabs.io/testfablab"
                                }
                        }
                }
        }

+ Response 200 (application/json)


+ Response 400 (application/json)

        { 
            "errors":
                [
                    {
                        "status":"400",
                        "code":"400",
                        "title":"Bad request",
                        "details":"The server cannot or will not process the request due to an apparent client error."
                    },
                ]
        }
        
+ Response 500 (application/json)

        { 
            "errors":
                [
                    {
                        "status":"500",
                        "code":"500",
                        "title":"Internal Server Error",
                        "details": "An unexpected condition caused an internal server error."
                    },
                ]
        }


### Lab [PUT]

+ Response 200 (application/json)


### Lab [DELETE]

+ Response 200 (application/json)


## Lab Status [/labs/{lab_id}/status]

### Lab Status [GET]

+ Parameters
    + lab_id (string) - Fab lab unique id.

+ Response 200 (application/json)
    

        {
            "data":
                {
                    "id": 341151,
                    "attributes": 
                        {
                            "title": "We are live!"
                            "description": "We are sending messages from our mobile lab.",
                            "location": 
                                {
                                    "geocomplete": "Carrer+de+la+Canuda,+45-47,+08002+Barcelona,+Barcelona,+Spain",
                                    "address_1": "Barcelona",
                                    "address_2": "Plaza+de+Catalunya",
                                    "city": "Barcelona",
                                    "postal_code": "08002",
                                    "country_code": "es",
                                    "coordinates": 
                                        {
                                            "latitude": "41.3850595",
                                            "longitude" : "2.173406699999987"
                                        }
                                },
                        },
                    "relationship":
                        {
                            "lab": 
                                {
                                    "id": 124,
                                    "attributes":
                                        {
                                            "name": "TestLab21",
                                            "blurb": "This is a test fab lab.",
                                            "description": "This is a test lab. Just ignore everything about it.",
                                            "slug": "testlab21",
                                            "email": "email@fablabs.io"
                                        },
                                    "links":
                                        {
                                            "self": "https://api.fablabs.io/testfablab"
                                        }
                                },
                        },
                    "meta":
                        {
                        },
                    "links":
                        {
                        }
                }
        }



    
### Lab Status [POST]

+ Parameters
    + lab_id (string) - Fab lab unique id.

+ Request

        {
            "data": 
                {
                    "status": 
                        {
                            "attributes":
                                {
                                    "title": "Yay!",
                                    "description": "We are posting a status!",
                                    "location": 
                                    {
                                        "coordinates": 
                                            {
                                                "latitude": "41.3850595",
                                                "longitude" : "2.173406699999987"
                                            }
                                    },
                                },
                            "relationship":
                                {
                                    "lab": 
                                        {
                                            "id": 124,
                                        }
                                }
                        }
                }
        }
    
+ Response 200 (application/json)


## Projects Collection [/projects]

### List All Projects [GET]

+ Response 200 (application/json)

        { 
            "data":
                {
                    "projects": 
                        [
                            {
                                "id":49,
                                "attributes": {
                                    "title": "RETAZO by: Toshiro/Ricardo",
                                    "description": "Retazo is an Open Source Product Design Style based primarily on CNC process created by Toshiro Tabuchi and Ricardo Torres from Peru. It has the possibility to be customizable and parametric. But the main contribution of this project is the extreme optimization as a formal style that sets a challenge for all makers, designers and users around the world. \r\nDigital Fabrication makes possible to empower the user to make personalized things, but a huge power means a big responsibility, that is why a correct use of processes and resources is really important. Mixing the digital fabrication with analogical processes helps to make more competitive projects.\r\nThe Retazo Project started as an attempt to improve the process of nesting and efficiency of CNC cutting. Thanks to this improvement there are less material wastes and the machine working time is reduced. All the pieces of furniture “Retazo” are united with the common CNC joints that are really simple. The tables and chairs have a very intuitive assembly system, are user-friendly and at this way the use of analogical processes is promoted as a very useful complement to the digital Fabrication.\r\nWe wanted to design products with a style that considers functionality and efficiency to reach a really good design in the third industrial revolution. We are looking for sharing this project and we are hoping that the makers of the world will use the method offered by “Retazo Project” and will implement it in their designs. \r\n",
                                    "faq": "¿How can I really optimize the usage of material applying the “Retazo” technique?\r\nBascally in two levels, but you should consider that more important than this is the functionality and aestetic of the product. Because of that we consider that Retazo is a challenge for each Maker.\r\n\r\nOptimization of Material: Using all the surface of the plywood board one can reach a perfect nesting process. The perfect nesting process means to not waste the material.\r\n\r\nOptimization of use of the Machine: While optimizing the nesting in an extreme way, the cut of pieces means also the cut of another piece. Also the time of cutting is reducing. The two of our tables could be fabricated in approximately 20 minutes depending on the machine characteristics that is used.\r\n\r\n\r\n¿What kind of cutter is better to use for milling?\r\nWe recommend to use a down-cut mill for the CNC, and for the fillet and finishing, a trimer tupia and a corner around router bit. \r\n\r\n\r\n¿How do you fix a board?\r\nOf course it is more difficult when you don’t have a vacuum equipment because usually one fixes the board using the some instruments. Without the vacuum equipment one should look for some smart solutions. We prefer some strategies like using taps and screws in strategic positions. \r\n\r\n\r\n¿Does it means less freedom of personalization in the digital fabrication?\r\nThe “Retazo Project” is a challenge for all makers! Everybody can do more products with less material usage. It means that one has to think more on each design. So, each one will be planned better. This method will help to save money, material and to contribute to the environment rescue. Do you accept the challenge?\r\n\r\n\r\n¿Why Open Source design?\r\nWe want to share our models and style to encourage people to think more about using the possibilities of digital fabrication. Our goal is also to fabricate more designs of this kind to expand the idea of optimization and combination of processes of analogical and digital fabrication.\r\n","scope":"In our country and in most cities of Latin America, the majority of CNC machines are being used just to cut signboards and letters. So, the possibility of demonstration of a functional and innovative use of digital fabrication, could change this tendency and the business models of some small companies in Latin America. And even better when the furniture or products made by “Retazo” are showed to them as designed and developed in their own country for the entire world.\r\nThe main objective of Retazo Project is to encourage and inspire makers of all the world to create innovative designs. Our goal consists of encouraging small local CNC shops and small companies to create products and to use the digital fabrication combined with analogical processes to make local profitable and adaptable production.  \r\nIt is also an opportunity for us to show that almost everything possible. As a motivation and support we are designing a sort of guide to build more optimized and ecologically friendly projects.\r\nTo make a global project with the help of different Open Source platforms is our dream. As the majority of Open Designs of this industrial revolution we want to share and commercialize our designs in order to put a challenge to all FabLabs, Makerspaces, Hackerspaces, CNC Shops. \r\n",
                                    "cover":null
                                },
                                "links": 
                                    {
                                        "self": "https://api.fablabs.io/projects/49"
                                        "github":"",
                                        "web":"",
                                        "dropbox":"",
                                        "bitbucket":"",
                                        "vimeo": "",
                                        "flickr": "",
                                        "youtube": "",
                                        "drive": "https://docs.google.com/presentation/d/1_rNMzjH3KSvYudQR4JWG4blGncBimEiIlVba3exnPFU/edit?usp=sharing",
                                        "twitter": "",
                                        "facebook": "",
                                        "googleplus": "",
                                        "instagram": "",
                                    },
                                "meta": {
                                    "lab_id": 245,
                                    "owner_id": 3802,
                                    "created_at":"2015-07-22T06:05:37.436Z",
                                    "updated_at":"2015-07-22T19:40:00.553Z",
                                    "status":null,
                                    "version":null,
                                    "collaborations":
                                        {
                                        },
                                    "contributors":
                                        {
                                        },
                                    "community":null,
                                    "lookingfor":null,
                                }
                            },
                        ]
                }
        }




## Events Collection [/events]

### List All Events [GET]

+ Response 200 (application/json)

        { 
            "data":
                {
                    "events":
                        [
                            {
                                "id": "123",
                                "type": "workshop",
                                "attributes": 
                                    {
                                        "title": "A great event!",
                                        "description": "This is an event",
                                        "faq": "What are we going to do? We are going to learn about fablabs",
                                        "location": 
                                            {
                                                "geocomplete": "Carrer+de+la+Canuda,+45-47,+08002+Barcelona,+Barcelona,+Spain",
                                                "address_1": "Barcelona",
                                                "address_2": "Plaza+de+Catalunya",
                                                "city": "Barcelona",
                                                "postal_code": "08002",
                                                "country_code": "es",
                                                "coordinates": 
                                                    {
                                                        "latitude": "41.3850595",
                                                        "longitude" : "2.173406699999987"
                                                    }
                                            },
                                        "payment-method": 
                                            {   
                                                "type": "one-time",
                                                "attributes":
                                                    {
                                                        "accepted":
                                                            [
                                                                "paypal",
                                                                "bitpay"
                                                            ]
                                                    },
                                                "links": 
                                                    {
                                                        "paypal": "www.paypal.com/1231",
                                                        "bitpay": "www.bitpay.com/sdajkl"
                                                    }
                                                    
                                            }
                                    },
                                "relationships":
                                    {
                                        "attendees": 
                                            [
                                                {
                                                    "id": 213,
                                                    "attributes": 
                                                        {
                                                            "first_name": "John",
                                                            "last_name": "Smith",
                                                            "username": "john687"
                                                        },
                                                    "links": 
                                                        {
                                                            "self": "https://api.fablabs.io/users/213",
                                                            "github": "https://github.com/john687/"
                                                        }
                                                },
                                            ],
                                        "organizer": 
                                            {
                                                "id": "142",
                                                "type":"fab_lab",
                                                "attributes":
                                                    {
                                                        "slug": "fablabbcn",
                                                        "name": "Fab Lab BCN",
                                                        "blurb": "Fab Lab Barcelona is a centre of production, investigation and education, that uses the latest computer-assisted design software for the creation of prototypes and scale models.","description":"Fab Lab Barcelona is a centre of production, investigation and education, that uses the latest computer-assisted design software for the creation of prototypes and scale models for Architecture, Construction and Industrial Design.",
                                                    },
                                                "links": 
                                                    {  
                                                        "self": "https://api.fablabs.io/events/2315",
                                                                
                                                    },
                                                "meta":
                                                    {
                                                        "media": 
                                                            [
                                                                {
                                                                    "id": 2314,
                                                                    "type": "image/jpg",
                                                                    "attributes": 
                                                                        {
                                                                            "title": "Amazing pic",
                                                                            "description": "This is a place for the event",
                                                                        },
                                                                    "links":
                                                                        {
                                                                            "self": "https://api.fablabs.io/events/2315/media/images/pic-2314.jpg"
                                                                        }
                                                                }
                                                            ],
                                                    }
                                            },
                                    }
                            },
                        ]
                }
        }




## Machines Collection [/machines]

### List All Machines [GET]

+ Response 200 (application/json)

        { 
            "data":
                {
                    "machines": 
                        [
                            {
                                "id": 123156,
                                "type": "laser",
                                "attributes":
                                    {
                                        "name": "Spirit GX 40W",
                                        "brand":
                                            {
                                                "id": 24151,
                                                "attributes":
                                                    "name": "LaserPRO",
                                                    "description": "Laser Machines"
                                            },
                                        "description": "LaserPRO - Spirit GX 40W",
                                    },
                                    "links": 
                                        {
                                            "media": 
                                                {
                                                    "type": "photo",
                                                    "href": "https://api.fablabs.io/machines/2312315/media/images/pic-2312315.jpg"
                                                }
                                                
                                        },
                                    "meta":
                                        {
                                            "creator_id": "213"
                                            "created_at":"2015-07-22T06:05:37.436Z",
                                            "updated_at":"2015-07-22T19:40:00.553Z",
                                            "tags":
                                                [
                                                    
                                                ]
                                        },
                                    "relationships":
                                        {
                                            "at": 
                                            [
                                                {
                                                    "id": "142",
                                                    "type":"fab_lab",
                                                    "attributes":
                                                        {
                                                            "slug": "fablabbcn",
                                                            "name": "Fab Lab BCN",
                                                            "blurb": "Fab Lab Barcelona is a centre of production, investigation and education, that uses the latest computer-assisted design software for the creation of prototypes and scale models.","description":"Fab Lab Barcelona is a centre of production, investigation and education, that uses the latest computer-assisted design software for the creation of prototypes and scale models for Architecture, Construction and Industrial Design.",
                                                        },
                                                    "links": 
                                                        {  
                                                            "self": "https://api.fablabs.io/events/2315",
                                                                    
                                                        },
                                                    "meta":
                                                        {
                                                            "media": 
                                                                [
                                                                    {
                                                                        "id": 2314,
                                                                        "type": "image/jpg",
                                                                        "attributes": 
                                                                            {
                                                                                "title": "Amazing pic",
                                                                                "description": "This is a place for the event",
                                                                            },
                                                                        "links":
                                                                            {
                                                                                "self": "https://api.fablabs.io/events/2315/media/images/pic-2314.jpg
                                                                            }
                                                                    }
                                                                ],
                                                        }
                                                }
                                            ]
                                        }
                            },
                        ]
                }
        }



    
## People Collection [/people]

### List All People [GET]

+ Response 200 (application/json)

        { 
            "data":
                {
                    "people":
                        [
                            {
                                "id": 213,
                                "type": "user",
                                "attributes": 
                                    {
                                        "first_name": "John",
                                        "last_name": "Smith",
                                        "username": "john687"
                                    },
                                "meta":
                                    {
                                        "skills":
                                            [
                                                "design",
                                                "frontend",
                                            ],
                                        "activities":
                                            [
                                                {
                                                    "id": 6723,
                                                    "type": "update",
                                                    "attributes":
                                                        {
                                                            "title": "Updated Fablab",
                                                            "description": "John Updated Fablab NYC"
                                                        },
                                                    "meta":
                                                        {
                                                            "lab":
                                                                {
                                                                    "id": 123,
                                                                    "type": "fablab",
                                                                    "links":
                                                                        {
                                                                            "self": "https://api.fablabs.io/labs/123"
                                                                        }
                                                                }
                                                        }
                                                    
                                                }
                                            ]
                                    },
                                "links": 
                                    {
                                        "self": "https://api.fablabs.io/people/213",
                                        "github": "https://github.com/john687/"
                                    },
                                "relationships":
                                    {
                                        "projects":
                                            [
                                                {
                                                    "id":49,
                                                    "attributes": {
                                                        "title": "RETAZO by: Toshiro/Ricardo",
                                                        "description": "Retazo is an Open Source Product Design Style based primarily on CNC process created by Toshiro Tabuchi and Ricardo Torres from Peru. It has the possibility to be customizable and parametric. But the main contribution of this project is the extreme optimization as a formal style that sets a challenge for all makers, designers and users around the world. \r\nDigital Fabrication makes possible to empower the user to make personalized things, but a huge power means a big responsibility, that is why a correct use of processes and resources is really important. Mixing the digital fabrication with analogical processes helps to make more competitive projects.\r\nThe Retazo Project started as an attempt to improve the process of nesting and efficiency of CNC cutting. Thanks to this improvement there are less material wastes and the machine working time is reduced. All the pieces of furniture “Retazo” are united with the common CNC joints that are really simple. The tables and chairs have a very intuitive assembly system, are user-friendly and at this way the use of analogical processes is promoted as a very useful complement to the digital Fabrication.\r\nWe wanted to design products with a style that considers functionality and efficiency to reach a really good design in the third industrial revolution. We are looking for sharing this project and we are hoping that the makers of the world will use the method offered by “Retazo Project” and will implement it in their designs. \r\n",
                                                        "faq": "¿How can I really optimize the usage of material applying the “Retazo” technique?\r\nBascally in two levels, but you should consider that more important than this is the functionality and aestetic of the product. Because of that we consider that Retazo is a challenge for each Maker.\r\n\r\nOptimization of Material: Using all the surface of the plywood board one can reach a perfect nesting process. The perfect nesting process means to not waste the material.\r\n\r\nOptimization of use of the Machine: While optimizing the nesting in an extreme way, the cut of pieces means also the cut of another piece. Also the time of cutting is reducing. The two of our tables could be fabricated in approximately 20 minutes depending on the machine characteristics that is used.\r\n\r\n\r\n¿What kind of cutter is better to use for milling?\r\nWe recommend to use a down-cut mill for the CNC, and for the fillet and finishing, a trimer tupia and a corner around router bit. \r\n\r\n\r\n¿How do you fix a board?\r\nOf course it is more difficult when you don’t have a vacuum equipment because usually one fixes the board using the some instruments. Without the vacuum equipment one should look for some smart solutions. We prefer some strategies like using taps and screws in strategic positions. \r\n\r\n\r\n¿Does it means less freedom of personalization in the digital fabrication?\r\nThe “Retazo Project” is a challenge for all makers! Everybody can do more products with less material usage. It means that one has to think more on each design. So, each one will be planned better. This method will help to save money, material and to contribute to the environment rescue. Do you accept the challenge?\r\n\r\n\r\n¿Why Open Source design?\r\nWe want to share our models and style to encourage people to think more about using the possibilities of digital fabrication. Our goal is also to fabricate more designs of this kind to expand the idea of optimization and combination of processes of analogical and digital fabrication.\r\n","scope":"In our country and in most cities of Latin America, the majority of CNC machines are being used just to cut signboards and letters. So, the possibility of demonstration of a functional and innovative use of digital fabrication, could change this tendency and the business models of some small companies in Latin America. And even better when the furniture or products made by “Retazo” are showed to them as designed and developed in their own country for the entire world.\r\nThe main objective of Retazo Project is to encourage and inspire makers of all the world to create innovative designs. Our goal consists of encouraging small local CNC shops and small companies to create products and to use the digital fabrication combined with analogical processes to make local profitable and adaptable production.  \r\nIt is also an opportunity for us to show that almost everything possible. As a motivation and support we are designing a sort of guide to build more optimized and ecologically friendly projects.\r\nTo make a global project with the help of different Open Source platforms is our dream. As the majority of Open Designs of this industrial revolution we want to share and commercialize our designs in order to put a challenge to all FabLabs, Makerspaces, Hackerspaces, CNC Shops. \r\n",
                                                        "cover": null
                                                    },
                                                    "links": 
                                                        {
                                                            "self": "https://api.fablabs.io/projects/49"
                                                        },
                                                },
                                            ]
                                    }
                                
                            }
                        ]
                }
        }

    
## Application Authentication [/auth/applications?{redirect_uri}&{response_type}&{client_id}]

Please check OAuth Protocol Flow (https://tools.ietf.org/html/rfc6749)

### Authenticate application implicit OAuth flow [GET]

+ Parameters
    + redirect_uri (string) - Redirect URI on app
    + response_type (string) - Always code
    + client_id (string) - Client ID

+ Response 302 (text/html)

    + Headers
        
            Location: https://api.fablabs.io/signin?goto=%2Foauth%2Fauthorize%3Fclient_id%3D1204a007bebfe971ec89db90a0b994db8c49327f2cbed2c6c7bcbd13f471697a%26redirect_uri%3Dhttps%253A%252F%252Foauth-fablabs-io.herokuapp.com%252Fcallback%26response_type%3Dcode
            Set-Cookie: _fablabs_session=OEZFa1ZyaXVCUWZGVld5RFdtZnd3enZaMFBpUEQzcmVXbVdIYXoySlRYYnVHZkI5NG56a2tMUE80U3h0NFNWUHBBMGVXVEhRYU42aVBJa0lFVVNNZkEzSXVGaTlWeEtoa0M1dCthYTQvbi84K0xwRjA2azBKTjdiUWUvTSt2WEM3RW0wZ0c5bTdHQ2k2RlpwbjlKc1ZBOXdRY2hkVnJoR2V1cmFzVW1pMXBiQ0tqQ1VSa2JxYnlMY0FOcWQ0TUdNLS1uUXYrSzZ0S0trdlE3cVpWUEt2dUpBPT0%3D--2f244bac1b08de67b54b102206ade82f0e3af34c; domain=.fablabs.io; path=/; secure; HttpOnly
            Status: 302 Found




## User Authentication [/auth/sessions]

Please check OAuth Protocol Flow (https://tools.ietf.org/html/rfc6749)

### Authenticate user [POST]

+ Request (application/json)

        {
            "authenticity_token": "l2yUnGCJ1r/1fFBrfWdfCdtZgni8IzMV2IBWEWXmWY8=",
            "goto": "/oauth/authorize?client_id=1204a007bebfe971ec89db90a0b994db8c49327f2cbed2c6c7bcbd13f471697a&redirect_uri=https%3A%2F%2Foauth-fablabs-io.herokuapp.com%2Fcallback&response_type=code",
            "email_or_username": "email@fablabs.io"
            "password": "MySuperStrongPassword!"
        }

+ Response 302 (text/html)

    + Headers
    
            Location: https://api.fablabs.io/oauth/authorize?client_id=1204a007bebfe971ec89db90a0b994db8c49327f2cbed2c6c7bcbd13f471697a&redirect_uri=https%3A%2F%2Foauth-fablabs-io.herokuapp.com%2Fcallback&response_type=code
            Set-Cookie: _fablabs_session=ejN2a3NQc1RnbWFEbkJCV0RlNk40UkZhQVZWVlBwRGlzWUtKQUcrbEw5VGx5cDRiUjZsaEtaekJxL015dWhpQ3M4TTNvY1VrS2ZqbEEwS1NiNXE3Zm1INUNCYWZLWUZPU1V1enRoL3NFTEJIOHVIUkdOdk43MlE2NUdvSzUwZk9nQUtyUEJzMitROHZScW1xMFhweFo3TkNYM200eUg1L2JWYWdMdk9aTDFOa3RkanNEZjVzSU9mR1dzNHBYb2FvMGNNZzcyKzYyRjRzVnM4ZlBHT1VuYTFZMXhGMFVjQ0wvZm5nTjJlMlZLYXB1SUVBR1B4RDk4cHZGbjIxTTluK2V3YlVYQTNyTk5qUTFJNGQ2K1Vad3N5TERGOTBFbGUxVWVxUkNZZkJrenc9LS10aVdDeXJrMk1PbU9pT1VGWktEbk5BPT0%3D--fc4c22c15f0c4badd7af795b05b19a01e258b046; domain=.fablabs.io; path=/; secure; HttpOnly
            Status: 302 Found


## User Authorization [/auth/authorize?{client_id}&{redirect_uri}&{response_type}]

Please check OAuth Protocol Flow (https://tools.ietf.org/html/rfc6749)

### Authorize user [GET]

+ Request (application/json)

        {
            "redirect_uri": "https://oauth-fablabs-io.herokuapp.com/callback",
            "client_id": "1204a007bebfe971ec89db90a0b994db8c49327f2cbed2c6c7bcbd13f471697a",
            "response_type": "code"
        }

+ Parameters
    + redirect_uri (string) - Redirect URI on app
    + response_type (string) - Always code
    + client_id (string) - Client ID

+ Response 302 (text/html)

    + Headers
    
            Location: https://oauth-fablabs-io.herokuapp.com/callback?code=76bc2fad088c159c75cc0c93008b1076e93ea7f66c8d392fc4b647aceba6fc97
            Set-Cookie: _fablabs_session=MVdRS080RUpyQm4xT3VHMEhjYVl0d1NOUjdJMWY5L2pFeXhnU0RTUUxTbHFZelRvdi9KRmZXVXB2aHdXRGNTZVhiSFFuNVVrclppM1o1RTNiOFZzdnNEQ3d1S0ZaQ1ZTb09MR2V5UG55QXV3T3F4TTlCenM2WWNWU29KeUJuWVY0RExyTHJ6Y1VsZDgwTVJsV3VSOUcycVJaN3l1Uk4ydGtsWnhkQUl2S2dTcURNNkZuM0NPUTl1STBOR1RSMk92TGNSemZMSnpPcm9rZjFOUGhZT2ZESDNpSVFHaTJSZ3RiUy8xVThla3BFQzFLNHlvVys0SUdJbEt1Q1B6eElGRGF2Qk81T2JraDJocnZFeWlrSVNyZzQ3eFZVNG5pSHpnMGdZbE9jK3puM0U9LS1KUVJ3SWgrdzIxYlNUOUJaRmRqZjZnPT0%3D--37c55f0ec07b422c4148710cb586d6cb0ea0c1f2; domain=.fablabs.io; path=/; secure; HttpOnly
            Status: 302 Found


## Tags Colletion [/tags]

### List of tags used across the platform [GET]

+ Response 200 (application/json)

        {
            "data": 
                {
                    "tags":
                        [
                            {
                                "id": 2131,
                                "attributes": 
                                    {
                                        "name": "opensource"
                                    },
                                "meta": 
                                    {
                                        "frequency": "0.6"
                                    },
                                "links":
                                    {
                                        "self": "https://api.fablabs.io/tags/opensource"
                                    }
                                
                            }
                        ]
                }
        }


## Tag [/tags/{tag}]

### Information for a single tag [GET]

+ Parameters
    + tag (string) - Tag name


+ Response 200 (application/json)

        {
            "data": 
                {
                    
                    {
                        "id": 2131,
                        "attributes": 
                            {
                                "name": "opensource"
                            },
                        "meta": 
                            {
                                "frequency": "0.6",
                            },  
                        "links":
                            {
                                "self": "https://api.fablabs.io/tags/opensource"
                            },
                        "relationships":
                            {
                                "in": 
                                    {
                                        "people": 
                                            [
                                                {
                                                }
                                            ],
                                        "projects":
                                            [   
                                                {
                                                }
                                            ],
                                        "labs":
                                            [   
                                                {
                                                }
                                            ],
                                        "events":
                                            [   
                                                {
                                                }
                                            ],
                                        "machines":
                                            [
                                                {
                                                }
                                            ]
                                    },
                            }
                    }
                }
        }




## Activities Collection [/activities]

### List of latest activity across the platform [GET]

+ Response 200 (application/json)

        { 
            "data":
                {
                }
        }




## Activity [/activities/{activity}]

### Activity [GET]

+ Parameters
    + activity (string) - Activity name

+ Response 200 (application/json)

        { 
            "data":
                {
                }
        }




## Blockchain [/blockchain]

### Endpoint to query fablabs.io blockchain
    
+ Response 200 (application/json)

        { 
            "data":
                {
                }
        }




## Block [/blockchain/block]

### Endpoint to retrieve block information

+ Response 200 (application/json)

    
        {
            "data":
                {
                    
                }
        }
 
 
 
        
## Transaction [/blockchain/transaction]

### Endpoint to retrieve transaction information

+ Response 200 (application/json)

    
        {
            "data":
                {
                    
                }
        }