"<p>In this video, we'll show you how to use RAML and MuleSoft's Anypoint Platform to build your first API specifications using API Designer.</p> <h2><br /> <strong>What is RAML ? </strong></h2> <p>RAML (RESTful API Modeling Language) is a new language designed to help developers quickly design and document REST APIs.</p> <h3><br /> <strong>Public Free API's List : </strong></h3> <ol> <li>Bored API : <a href="https://www.boredapi.com/api/activity">Link</a></li> <li>Universities API : <a href="http://universities.hipolabs.com/search?country=tunisia">Link</a></li> <li>Places API: <a href="https://api.zippopotam.us/us/33162">Link</a></li> </ol> <p>In the following, we'll provide some code examples that show how we built the specifications for these API's.<br /> We'll start with some basic examples and move on to more complex ones.</p> <p><strong>Bored API Specifications: </strong></p> <pre> <code>#%RAML 1.0 title: Bored API baseUri: https://www.boredapi.com/api/ description: Lorum Ipsum version: 1.0 documentation: - content: test title: Bored API protocols: - HTTPS types: Result: type: object properties: activity: string type: string participants: integer price: integer link: string key: number accessibility: number /activity: get: responses: 200: body: application/json: type: Result</code> </pre> <p><strong>Universities API Specifications:</strong> </p> <pre> <code>#%RAML 1.0 title: Universities API baseUri: http://universities.hipolabs.com version: 1.0 types: University: type: object properties: alpha_two_code: string domains: string[] web_pages: string[] name: string Result: type: University[] /search: get: responses: 200: body: application/json: type: Result queryParameters: country: string</code></pre>"