際際滷

際際滷Share a Scribd company logo
API Description
Languages
Swagger 0.8 API Blueprint
RAML
Swagger 1.2
Swagger 2.0RADL
That Microsoft Thing
Google API Discovery Protocol
Brief History of Time
Experimentation is good
Lang 1
AST
awesomeness
parse
use
Usage
Usage
Lang 1
AST
awesomeness
parse
use
Lang 2
parse
AST
use
UsageLang 1
AST
data model
parse
normalize
Lang 2
parse
AST
normalize
awesomeness
use
This is happening all over
Most dont bother
Solution!
abstraction
https://github.com/refractproject
https://github.com/refractproject
recursive data structure for expressing
complex structures, relationships, and metadata.
Refract
A library for interacting with Refract elementsMinim
https://github.com/refractproject/refract-spec
"foobar"
{
"element": "string"
"content": foobar",
"meta": {},
"attributes": {}
}
https://github.com/refractproject/refract-spec
https://github.com/refractproject/minim
Easy querying of refracted data
let namespace = minim.namespace()
.use(apiDescription);
let api = namespace.fromCompactRefract();
Goal
Abstract away 90% usecases
Provide easy querying on all API Desc Langs

More Related Content

Viewers also liked (19)

Post-REST Manifesto
Post-REST ManifestoPost-REST Manifesto
Post-REST Manifesto
Jakub Nesetril
Harmony in API Design
Harmony in API DesignHarmony in API Design
Harmony in API Design
Jakub Nesetril
Avoiding API Waterfalls
Avoiding API WaterfallsAvoiding API Waterfalls
Avoiding API Waterfalls
Jakub Nesetril
NodeJS, CoffeeScript & Real-time Web
NodeJS, CoffeeScript & Real-time WebNodeJS, CoffeeScript & Real-time Web
NodeJS, CoffeeScript & Real-time Web
Jakub Nesetril
Budoucnost Web Aplikaci
Budoucnost Web AplikaciBudoucnost Web Aplikaci
Budoucnost Web Aplikaci
Jakub Nesetril
Startup Accelerators
Startup AcceleratorsStartup Accelerators
Startup Accelerators
Jakub Nesetril
Introduction to GoodData BI PaaS
Introduction to GoodData BI PaaSIntroduction to GoodData BI PaaS
Introduction to GoodData BI PaaS
Jakub Nesetril
Art of Building APIs
Art of Building APIsArt of Building APIs
Art of Building APIs
Jakub Nesetril
REST API tools
REST API toolsREST API tools
REST API tools
Jakub Nesetril
Advanced Regular Expressions Redux
Advanced Regular Expressions ReduxAdvanced Regular Expressions Redux
Advanced Regular Expressions Redux
Jakub Nesetril
Introduction to node.js
Introduction to node.jsIntroduction to node.js
Introduction to node.js
Jakub Nesetril
GoodData: One Stop Shop for Analytics
GoodData: One Stop Shop for AnalyticsGoodData: One Stop Shop for Analytics
GoodData: One Stop Shop for Analytics
Jakub Nesetril
Let's Have a Cup of CoffeeScript
Let's Have a Cup of CoffeeScriptLet's Have a Cup of CoffeeScript
Let's Have a Cup of CoffeeScript
Nicol叩s Sanguinetti
Node at Apiary.io
Node at Apiary.ioNode at Apiary.io
Node at Apiary.io
Jakub Nesetril
Apiary
ApiaryApiary
Apiary
Suresh B
API Design Workflows
API Design WorkflowsAPI Design Workflows
API Design Workflows
Jakub Nesetril
Real-time Web a NodeJS
Real-time Web a NodeJSReal-time Web a NodeJS
Real-time Web a NodeJS
Jakub Nesetril
Microservice Stategies - Scaling your API design workflow
Microservice Stategies - Scaling your API design workflowMicroservice Stategies - Scaling your API design workflow
Microservice Stategies - Scaling your API design workflow
Jakub Nesetril
Effingham 2 Apiary Development Grant Gillard
Effingham 2 Apiary Development Grant GillardEffingham 2 Apiary Development Grant Gillard
Effingham 2 Apiary Development Grant Gillard
Grant Gillard
Post-REST Manifesto
Post-REST ManifestoPost-REST Manifesto
Post-REST Manifesto
Jakub Nesetril
Harmony in API Design
Harmony in API DesignHarmony in API Design
Harmony in API Design
Jakub Nesetril
Avoiding API Waterfalls
Avoiding API WaterfallsAvoiding API Waterfalls
Avoiding API Waterfalls
Jakub Nesetril
NodeJS, CoffeeScript & Real-time Web
NodeJS, CoffeeScript & Real-time WebNodeJS, CoffeeScript & Real-time Web
NodeJS, CoffeeScript & Real-time Web
Jakub Nesetril
Budoucnost Web Aplikaci
Budoucnost Web AplikaciBudoucnost Web Aplikaci
Budoucnost Web Aplikaci
Jakub Nesetril
Startup Accelerators
Startup AcceleratorsStartup Accelerators
Startup Accelerators
Jakub Nesetril
Introduction to GoodData BI PaaS
Introduction to GoodData BI PaaSIntroduction to GoodData BI PaaS
Introduction to GoodData BI PaaS
Jakub Nesetril
Art of Building APIs
Art of Building APIsArt of Building APIs
Art of Building APIs
Jakub Nesetril
Advanced Regular Expressions Redux
Advanced Regular Expressions ReduxAdvanced Regular Expressions Redux
Advanced Regular Expressions Redux
Jakub Nesetril
Introduction to node.js
Introduction to node.jsIntroduction to node.js
Introduction to node.js
Jakub Nesetril
GoodData: One Stop Shop for Analytics
GoodData: One Stop Shop for AnalyticsGoodData: One Stop Shop for Analytics
GoodData: One Stop Shop for Analytics
Jakub Nesetril
API Design Workflows
API Design WorkflowsAPI Design Workflows
API Design Workflows
Jakub Nesetril
Real-time Web a NodeJS
Real-time Web a NodeJSReal-time Web a NodeJS
Real-time Web a NodeJS
Jakub Nesetril
Microservice Stategies - Scaling your API design workflow
Microservice Stategies - Scaling your API design workflowMicroservice Stategies - Scaling your API design workflow
Microservice Stategies - Scaling your API design workflow
Jakub Nesetril
Effingham 2 Apiary Development Grant Gillard
Effingham 2 Apiary Development Grant GillardEffingham 2 Apiary Development Grant Gillard
Effingham 2 Apiary Development Grant Gillard
Grant Gillard

Similar to Consuming API description languages - Refract & Minim (20)

How to Reverse Engineer Web Applications
How to Reverse Engineer Web ApplicationsHow to Reverse Engineer Web Applications
How to Reverse Engineer Web Applications
Jarrod Overson
Redis
RedisRedis
Redis
Gleicon Moraes
Screen Scraping with Ruby
Screen Scraping with RubyScreen Scraping with Ruby
Screen Scraping with Ruby
jeremyraines
JPA ろ磯 Week2 - Object Relational Mapping
JPA ろ磯 Week2 - Object Relational MappingJPA ろ磯 Week2 - Object Relational Mapping
JPA ろ磯 Week2 - Object Relational Mapping
Covenant Ko
Apache Zeppelin, Helium and Beyond
Apache Zeppelin, Helium and BeyondApache Zeppelin, Helium and Beyond
Apache Zeppelin, Helium and Beyond
DataWorks Summit/Hadoop Summit
JPA Week3 Entity Mapping / Hexagonal Architecture
JPA Week3 Entity Mapping / Hexagonal ArchitectureJPA Week3 Entity Mapping / Hexagonal Architecture
JPA Week3 Entity Mapping / Hexagonal Architecture
Covenant Ko
RDF APIs for .NET Framework
RDF APIs for .NET FrameworkRDF APIs for .NET Framework
RDF APIs for .NET Framework
Adriana Ivanciu
Getty Vocabulary Program LOD: Ontologies and Semantic Representation
Getty Vocabulary Program LOD: Ontologies and Semantic RepresentationGetty Vocabulary Program LOD: Ontologies and Semantic Representation
Getty Vocabulary Program LOD: Ontologies and Semantic Representation
Vladimir Alexiev, PhD, PMP
Testing for Ops: Going Beyond the Manifest - PuppetConf 2013
Testing for Ops: Going Beyond the Manifest - PuppetConf 2013Testing for Ops: Going Beyond the Manifest - PuppetConf 2013
Testing for Ops: Going Beyond the Manifest - PuppetConf 2013
Puppet
The design, architecture, and tradeoffs of FluidDB
The design, architecture, and tradeoffs of FluidDBThe design, architecture, and tradeoffs of FluidDB
The design, architecture, and tradeoffs of FluidDB
Terry Jones
Spl in the wild - zendcon2012
Spl in the wild - zendcon2012Spl in the wild - zendcon2012
Spl in the wild - zendcon2012
Elizabeth Smith
NoSQL and SQL Anti Patterns
NoSQL and SQL Anti PatternsNoSQL and SQL Anti Patterns
NoSQL and SQL Anti Patterns
Gleicon Moraes
Language-agnostic data analysis workflows and reproducible research
Language-agnostic data analysis workflows and reproducible researchLanguage-agnostic data analysis workflows and reproducible research
Language-agnostic data analysis workflows and reproducible research
Andrew Lowe
Learn python
Learn pythonLearn python
Learn python
Kracekumar Ramaraju
Golang Performance : microbenchmarks, profilers, and a war story
Golang Performance : microbenchmarks, profilers, and a war storyGolang Performance : microbenchmarks, profilers, and a war story
Golang Performance : microbenchmarks, profilers, and a war story
Aerospike
grlc: Bridging the Gap Between RESTful APIs and Linked Data
grlc: Bridging the Gap Between RESTful APIs and Linked Datagrlc: Bridging the Gap Between RESTful APIs and Linked Data
grlc: Bridging the Gap Between RESTful APIs and Linked Data
Albert Mero単o-Pe単uela
Spl in the wild
Spl in the wildSpl in the wild
Spl in the wild
Elizabeth Smith
Using spl tools in your code
Using spl tools in your codeUsing spl tools in your code
Using spl tools in your code
Elizabeth Smith
Scrapy.for.dummies
Scrapy.for.dummiesScrapy.for.dummies
Scrapy.for.dummies
Chandler Huang
Regex Considered Harmful: Use Rosie Pattern Language Instead
Regex Considered Harmful: Use Rosie Pattern Language InsteadRegex Considered Harmful: Use Rosie Pattern Language Instead
Regex Considered Harmful: Use Rosie Pattern Language Instead
All Things Open
How to Reverse Engineer Web Applications
How to Reverse Engineer Web ApplicationsHow to Reverse Engineer Web Applications
How to Reverse Engineer Web Applications
Jarrod Overson
Screen Scraping with Ruby
Screen Scraping with RubyScreen Scraping with Ruby
Screen Scraping with Ruby
jeremyraines
JPA ろ磯 Week2 - Object Relational Mapping
JPA ろ磯 Week2 - Object Relational MappingJPA ろ磯 Week2 - Object Relational Mapping
JPA ろ磯 Week2 - Object Relational Mapping
Covenant Ko
JPA Week3 Entity Mapping / Hexagonal Architecture
JPA Week3 Entity Mapping / Hexagonal ArchitectureJPA Week3 Entity Mapping / Hexagonal Architecture
JPA Week3 Entity Mapping / Hexagonal Architecture
Covenant Ko
RDF APIs for .NET Framework
RDF APIs for .NET FrameworkRDF APIs for .NET Framework
RDF APIs for .NET Framework
Adriana Ivanciu
Getty Vocabulary Program LOD: Ontologies and Semantic Representation
Getty Vocabulary Program LOD: Ontologies and Semantic RepresentationGetty Vocabulary Program LOD: Ontologies and Semantic Representation
Getty Vocabulary Program LOD: Ontologies and Semantic Representation
Vladimir Alexiev, PhD, PMP
Testing for Ops: Going Beyond the Manifest - PuppetConf 2013
Testing for Ops: Going Beyond the Manifest - PuppetConf 2013Testing for Ops: Going Beyond the Manifest - PuppetConf 2013
Testing for Ops: Going Beyond the Manifest - PuppetConf 2013
Puppet
The design, architecture, and tradeoffs of FluidDB
The design, architecture, and tradeoffs of FluidDBThe design, architecture, and tradeoffs of FluidDB
The design, architecture, and tradeoffs of FluidDB
Terry Jones
Spl in the wild - zendcon2012
Spl in the wild - zendcon2012Spl in the wild - zendcon2012
Spl in the wild - zendcon2012
Elizabeth Smith
NoSQL and SQL Anti Patterns
NoSQL and SQL Anti PatternsNoSQL and SQL Anti Patterns
NoSQL and SQL Anti Patterns
Gleicon Moraes
Language-agnostic data analysis workflows and reproducible research
Language-agnostic data analysis workflows and reproducible researchLanguage-agnostic data analysis workflows and reproducible research
Language-agnostic data analysis workflows and reproducible research
Andrew Lowe
Golang Performance : microbenchmarks, profilers, and a war story
Golang Performance : microbenchmarks, profilers, and a war storyGolang Performance : microbenchmarks, profilers, and a war story
Golang Performance : microbenchmarks, profilers, and a war story
Aerospike
grlc: Bridging the Gap Between RESTful APIs and Linked Data
grlc: Bridging the Gap Between RESTful APIs and Linked Datagrlc: Bridging the Gap Between RESTful APIs and Linked Data
grlc: Bridging the Gap Between RESTful APIs and Linked Data
Albert Mero単o-Pe単uela
Using spl tools in your code
Using spl tools in your codeUsing spl tools in your code
Using spl tools in your code
Elizabeth Smith
Regex Considered Harmful: Use Rosie Pattern Language Instead
Regex Considered Harmful: Use Rosie Pattern Language InsteadRegex Considered Harmful: Use Rosie Pattern Language Instead
Regex Considered Harmful: Use Rosie Pattern Language Instead
All Things Open

Recently uploaded (20)

IBM / MAINFRAME /RACF security-guide_pdf.pdf
IBM / MAINFRAME /RACF security-guide_pdf.pdfIBM / MAINFRAME /RACF security-guide_pdf.pdf
IBM / MAINFRAME /RACF security-guide_pdf.pdf
WILSON990330
Evolving Scala, Scalar conference, Warsaw, March 2025
Evolving Scala, Scalar conference, Warsaw, March 2025Evolving Scala, Scalar conference, Warsaw, March 2025
Evolving Scala, Scalar conference, Warsaw, March 2025
Martin Odersky
ESET Smart Security Crack + Activation Key 2025 [Latest]
ESET Smart Security Crack + Activation Key 2025 [Latest]ESET Smart Security Crack + Activation Key 2025 [Latest]
ESET Smart Security Crack + Activation Key 2025 [Latest]
umeerbinfaizan
Will Ai Eat the Industrial World? The End of Engineering as We Know it
Will Ai Eat the Industrial World? The End of Engineering as We Know itWill Ai Eat the Industrial World? The End of Engineering as We Know it
Will Ai Eat the Industrial World? The End of Engineering as We Know it
Christian Dahlen
Coreldraw 2021 Crack Latest Version 2025
Coreldraw 2021 Crack Latest Version 2025Coreldraw 2021 Crack Latest Version 2025
Coreldraw 2021 Crack Latest Version 2025
blouch31kp
Distributed systems: design, principles and experiencies
Distributed systems: design, principles and experienciesDistributed systems: design, principles and experiencies
Distributed systems: design, principles and experiencies
Andr辿s P辿rez Gil
Hands-On AWS: Java SDK + CLI for Cloud Developers
Hands-On AWS: Java SDK + CLI for Cloud DevelopersHands-On AWS: Java SDK + CLI for Cloud Developers
Hands-On AWS: Java SDK + CLI for Cloud Developers
Meetu Maltiar
Microsoft Office Crack + Product key Download Free Version 2025
Microsoft Office Crack + Product key Download Free Version 2025Microsoft Office Crack + Product key Download Free Version 2025
Microsoft Office Crack + Product key Download Free Version 2025
hamza752796
praxistreffen-bamberg-2025-worksophop.pdf
praxistreffen-bamberg-2025-worksophop.pdfpraxistreffen-bamberg-2025-worksophop.pdf
praxistreffen-bamberg-2025-worksophop.pdf
4Science
Adobe Illustrator Crack Download (Latest 2025)
Adobe Illustrator Crack Download (Latest 2025)Adobe Illustrator Crack Download (Latest 2025)
Adobe Illustrator Crack Download (Latest 2025)
blouch36kp
6 Best AI Tools for Contract Management.pdf
6 Best AI Tools for Contract Management.pdf6 Best AI Tools for Contract Management.pdf
6 Best AI Tools for Contract Management.pdf
Anadea
Wilcom Embroidery Studio E Crack 2025 FREE
Wilcom Embroidery Studio E Crack 2025 FREEWilcom Embroidery Studio E Crack 2025 FREE
Wilcom Embroidery Studio E Crack 2025 FREE
muhammadwaqaryounus6
ESET NOD32 Antivirus Crack with License Key 2025
ESET NOD32 Antivirus Crack with License Key 2025ESET NOD32 Antivirus Crack with License Key 2025
ESET NOD32 Antivirus Crack with License Key 2025
umeerbinfaizan
[Roundtable] Choreo - The AI-Native Internal Developer Platform as a Service
[Roundtable] Choreo - The AI-Native Internal Developer Platform as a Service[Roundtable] Choreo - The AI-Native Internal Developer Platform as a Service
[Roundtable] Choreo - The AI-Native Internal Developer Platform as a Service
WSO2
EMEA Virtual Marketo User Group - Adobe Summit 2025 Round Up
EMEA Virtual Marketo User Group - Adobe Summit 2025 Round UpEMEA Virtual Marketo User Group - Adobe Summit 2025 Round Up
EMEA Virtual Marketo User Group - Adobe Summit 2025 Round Up
BradBedford3
The Missing Voices: Unearthing the Impact of Survivorship Bias on Women in Cl...
The Missing Voices: Unearthing the Impact of Survivorship Bias on Women in Cl...The Missing Voices: Unearthing the Impact of Survivorship Bias on Women in Cl...
The Missing Voices: Unearthing the Impact of Survivorship Bias on Women in Cl...
Imma Valls Bernaus
PDF Reader Pro Crack FREE Download Latest Version
PDF Reader Pro Crack FREE Download Latest VersionPDF Reader Pro Crack FREE Download Latest Version
PDF Reader Pro Crack FREE Download Latest Version
waqarcracker5
mORMot 2 - Pascal Cafe 2025 in Nederlands
mORMot 2 - Pascal Cafe 2025 in NederlandsmORMot 2 - Pascal Cafe 2025 in Nederlands
mORMot 2 - Pascal Cafe 2025 in Nederlands
Arnaud Bouchez
Microsoft Office Crack 2019 Free Download
Microsoft Office Crack 2019 Free DownloadMicrosoft Office Crack 2019 Free Download
Microsoft Office Crack 2019 Free Download
tayab01kp
Windows 8.1 Pro Activator Crack Version [April-2025]
Windows 8.1 Pro Activator Crack Version [April-2025]Windows 8.1 Pro Activator Crack Version [April-2025]
Windows 8.1 Pro Activator Crack Version [April-2025]
jhonjosh91
IBM / MAINFRAME /RACF security-guide_pdf.pdf
IBM / MAINFRAME /RACF security-guide_pdf.pdfIBM / MAINFRAME /RACF security-guide_pdf.pdf
IBM / MAINFRAME /RACF security-guide_pdf.pdf
WILSON990330
Evolving Scala, Scalar conference, Warsaw, March 2025
Evolving Scala, Scalar conference, Warsaw, March 2025Evolving Scala, Scalar conference, Warsaw, March 2025
Evolving Scala, Scalar conference, Warsaw, March 2025
Martin Odersky
ESET Smart Security Crack + Activation Key 2025 [Latest]
ESET Smart Security Crack + Activation Key 2025 [Latest]ESET Smart Security Crack + Activation Key 2025 [Latest]
ESET Smart Security Crack + Activation Key 2025 [Latest]
umeerbinfaizan
Will Ai Eat the Industrial World? The End of Engineering as We Know it
Will Ai Eat the Industrial World? The End of Engineering as We Know itWill Ai Eat the Industrial World? The End of Engineering as We Know it
Will Ai Eat the Industrial World? The End of Engineering as We Know it
Christian Dahlen
Coreldraw 2021 Crack Latest Version 2025
Coreldraw 2021 Crack Latest Version 2025Coreldraw 2021 Crack Latest Version 2025
Coreldraw 2021 Crack Latest Version 2025
blouch31kp
Distributed systems: design, principles and experiencies
Distributed systems: design, principles and experienciesDistributed systems: design, principles and experiencies
Distributed systems: design, principles and experiencies
Andr辿s P辿rez Gil
Hands-On AWS: Java SDK + CLI for Cloud Developers
Hands-On AWS: Java SDK + CLI for Cloud DevelopersHands-On AWS: Java SDK + CLI for Cloud Developers
Hands-On AWS: Java SDK + CLI for Cloud Developers
Meetu Maltiar
Microsoft Office Crack + Product key Download Free Version 2025
Microsoft Office Crack + Product key Download Free Version 2025Microsoft Office Crack + Product key Download Free Version 2025
Microsoft Office Crack + Product key Download Free Version 2025
hamza752796
praxistreffen-bamberg-2025-worksophop.pdf
praxistreffen-bamberg-2025-worksophop.pdfpraxistreffen-bamberg-2025-worksophop.pdf
praxistreffen-bamberg-2025-worksophop.pdf
4Science
Adobe Illustrator Crack Download (Latest 2025)
Adobe Illustrator Crack Download (Latest 2025)Adobe Illustrator Crack Download (Latest 2025)
Adobe Illustrator Crack Download (Latest 2025)
blouch36kp
6 Best AI Tools for Contract Management.pdf
6 Best AI Tools for Contract Management.pdf6 Best AI Tools for Contract Management.pdf
6 Best AI Tools for Contract Management.pdf
Anadea
Wilcom Embroidery Studio E Crack 2025 FREE
Wilcom Embroidery Studio E Crack 2025 FREEWilcom Embroidery Studio E Crack 2025 FREE
Wilcom Embroidery Studio E Crack 2025 FREE
muhammadwaqaryounus6
ESET NOD32 Antivirus Crack with License Key 2025
ESET NOD32 Antivirus Crack with License Key 2025ESET NOD32 Antivirus Crack with License Key 2025
ESET NOD32 Antivirus Crack with License Key 2025
umeerbinfaizan
[Roundtable] Choreo - The AI-Native Internal Developer Platform as a Service
[Roundtable] Choreo - The AI-Native Internal Developer Platform as a Service[Roundtable] Choreo - The AI-Native Internal Developer Platform as a Service
[Roundtable] Choreo - The AI-Native Internal Developer Platform as a Service
WSO2
EMEA Virtual Marketo User Group - Adobe Summit 2025 Round Up
EMEA Virtual Marketo User Group - Adobe Summit 2025 Round UpEMEA Virtual Marketo User Group - Adobe Summit 2025 Round Up
EMEA Virtual Marketo User Group - Adobe Summit 2025 Round Up
BradBedford3
The Missing Voices: Unearthing the Impact of Survivorship Bias on Women in Cl...
The Missing Voices: Unearthing the Impact of Survivorship Bias on Women in Cl...The Missing Voices: Unearthing the Impact of Survivorship Bias on Women in Cl...
The Missing Voices: Unearthing the Impact of Survivorship Bias on Women in Cl...
Imma Valls Bernaus
PDF Reader Pro Crack FREE Download Latest Version
PDF Reader Pro Crack FREE Download Latest VersionPDF Reader Pro Crack FREE Download Latest Version
PDF Reader Pro Crack FREE Download Latest Version
waqarcracker5
mORMot 2 - Pascal Cafe 2025 in Nederlands
mORMot 2 - Pascal Cafe 2025 in NederlandsmORMot 2 - Pascal Cafe 2025 in Nederlands
mORMot 2 - Pascal Cafe 2025 in Nederlands
Arnaud Bouchez
Microsoft Office Crack 2019 Free Download
Microsoft Office Crack 2019 Free DownloadMicrosoft Office Crack 2019 Free Download
Microsoft Office Crack 2019 Free Download
tayab01kp
Windows 8.1 Pro Activator Crack Version [April-2025]
Windows 8.1 Pro Activator Crack Version [April-2025]Windows 8.1 Pro Activator Crack Version [April-2025]
Windows 8.1 Pro Activator Crack Version [April-2025]
jhonjosh91

Consuming API description languages - Refract & Minim