forked from raml-org/raml-org
-
Notifications
You must be signed in to change notification settings - Fork 0
/
share-support-your-api.html
42 lines (41 loc) · 3.75 KB
/
share-support-your-api.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
---
layout: page
title: Share & Support Your API
permalink: /developers/share-support-your-api
---
<p>The great thing about RAML is that it not only lets you design your API, but actually defines your API. This means
that this very same RAML spec can be used to integrate your API with other systems, and even generate SDKs for
today’s most popular languages.</p><p>Plus, with the <a href="http://www.apinotebook.com" target="_blank">API
Notebook</a> you can even offer interactive walk-throughs and sample use-cases for your API, while also letting
developers communicate back in a standardized format with your support team - making their job super easy!</p><h2>
SDK Generation</h2><p>Creating code libraries for your RESTful API in Java, .NET, PHP, Ruby, NodeJs, iOS, Windows,
Go, and more is as simple as clicking a button!</p><p>You’ll find several different community tools available to
create these SDKs so that your engineers don’t have to!</p><p>You can also take advantage of professional services
like <a href="http://apimatic.io" target="_blank">APIMatic.io</a> and <a href="https://restunited.com/"
target="_blank">RESTUnited</a>, which
offers generation of three SDKs with their free plan, and supports all of the above languages and more.</p><p>This
means you can easily created updated code libraries every time you update your API with no effort on your
engineering teams part - letting them focus their time on more important things - like new features!</p><h2>Third
Party Tooling</h2><p>Just as you can create SDKs with RAML, many companies have built-in support letting you pull in
your API’s resources, methods, and properties automatically!</p><p>For example, Oracle and MuleSoft offer enterprise
tools that let you easily connect to any API described in RAML just by pasting in the RAML spec URL. No more
guesswork, and no more having to manually setup your API calls in these popular tools.</p><h2>API Notebook</h2><p>
The API Notebook completely changes the way developers interact with APIs, letting them easily try making calls,
manipulating data, and even connecting to multiple APIs at the same time using basic JavaScript!</p><p>Using simple
markdown, you can create unlimited notebooks demonstrating different use cases or examples of how to use your
API.</p><p>Want to learn more? Just check out some of these sample use cases (and learn more at
apinotebook.com):</p>
<ul>
<li><a href="https://api-notebook.anypoint.mulesoft.com/examples/instagram" target="_blank">Search for cute kittens
on Instagram</a></li>
<li><a href="https://api-notebook.anypoint.mulesoft.com/examples/twitter" target="_blank">Find Your Last Follower on
Twitter</a></li>
<li><a href="https://api-notebook.anypoint.mulesoft.com/examples/github" target="_blank">Get a list of your GitHub
gists</a></li>
</ul><p>As you can see, the API Notebook takes all the guesswork out of HOW developers can use your API to accomplish
your most popular or important use-cases.</p><h3>Handling Support</h3><p>But what makes the API Notebook truly
unique is that ANYONE can create their own notebook. Users can easily clone your existing notebooks or create new
ones to share their exact use case - and let you immediately see what issue they’re REALLY having.</p><p>This means
no more digging through proprietary, partial code in order to figure out if the bug is in their code or in your API
- but rather knowing immediately if they did something wrong in their process of calling the API, or if there’s a
bug on your part.</p><p>This also lets your users debug their own calls to make sure they’re doing things right!</p>