blog.apiary.io
Crafting MSON—Apiary Blog
https://blog.apiary.io/2014/10/10/Crafting-MSON
I do need to describe data, give them a (semantic) meaning and explain what you might (or might not) get. Being a software engineer for so many years I have seen lots and lots of schemas, tables and arbitrary documents trying to capture what the data means. Have you ever seen a document on GitHub trying to describe a JSON blob? What if we can not only make them human readable but also a machine readable, so a program can verify whether an actual data matches what is written in this document? The initial ...
blog.apiary.io
Make it so — Apiary enters the Enterprise—Apiary Blog
https://blog.apiary.io/2014/10/22/Enterprise-Release
Make it so Apiary enters the Enterprise. It has been an exciting summer at Apiary. I joined at the beginning in June to lead Apiary’s enterprise project. This week, we’ve crossed 100,000 APIs described in Apiary. And today, we announce the result of a lot of discussion with customers Apiary for Enterprise. Again and again, we heard the same story from developers working on larger API projects. The story involves what some call an API style guide. Which methods should be private, and which public? If you ...
blog.apiary.io
Next Version of API Documentation—Apiary Blog
https://blog.apiary.io/2014/12/04/Next-Version-of-API-Documentation
Next Version of API Documentation. Starting today, we are setting the new documentation as the default for all new APIs. Now, when you create a new API, it’ll use the new three-column layout. Over the past few months we have heard a lot of your requests and added tons of great features in the new documentation. Let me highlight a few of them. I hope you will appreciate the live preview of the new documentation next to the Apiary web editor; preview is updated in real-time as you type. The production URL (.
blog.apiary.io
Sharing Is Caring - Socialize Your Public API Blueprints—Apiary Blog
https://blog.apiary.io/2015/03/26/ApiBlueprint-button
Sharing Is Caring - Socialize Your Public API Blueprints. Have you ever stumbled upon an API that was so beautifully documented and wondered, how did they do that? Well, at Apiary we believe that effective learning happens through socialization and collaboration. To help support this belief and the inspiration that stems from beautifully documented APIs, we added the ability to socialize blueprints. Whenever you’re viweing public documentation, a new API Blueprint. So, what are you waiting for?
blog.apiary.io
API Blueprint on GitHub—Apiary Blog
https://blog.apiary.io/2015/06/03/API-Blueprint-GitHub
API Blueprint on GitHub. Collaboration and continuous integration are the heart of every good API design. This is why we care about integration with CI services and GitHub. I am happy to announce the major milestone for API Blueprint. API Blueprint is now recognized as a language on GitHub! All you need to do is to append the. Extension to your blueprint file and push it to GitHub. On GitHub every public blueprint gets indexed. This enables a search for indexed blueprints. Just add. To your search query:.
blog.apiary.io
API Design: Mind Maps & Surfing—Apiary Blog
https://blog.apiary.io/2014/03/06/Surfing-API
API Design: Mind Maps and Surfing. When I saw the above API mind map in the excellent article Quickly Prototype APIs with Apiary. I have jumped up. It never occurred to me before. This is a web structure! This is how Internet works! You go to the root of a site and let the links drive you to whatever the site has to offer. Surfing the web they say. Could this be done with an API? Is it possible explore and consume API resources by something as simple and natural as browsing? Building the API with Apiary.
command-line-interface.apievangelist.com
API Command Line Interface Tooling
http://command-line-interface.apievangelist.com/tools
Return to API Evangelist. These are the open source management related tooling that I am tracking on as part of my research, and can be used as part of the API command line interface process. CLI interface to Algorithmia algorithms and data API. The Apiary CLI gem is a command line tool for developing and previewing API Blueprint documents locally. It can also be used for pushing updated documents to and fetching existing documents from Apiary.io. A Command Line Interface (CLI) for apiman. Generates a co...
blog.apiary.io
Hyperdrive—Apiary Blog
https://blog.apiary.io/2015/06/04/Hyperdrive
It’s extremely common to build API clients which are tightly coupled to implementation detail. If you look at most API clients you will often find hard-coded details about how an API works such as the HTTP methods to use, URIs and information about content types. We design our clients and APIs around out-of-band specifications which overly couple our clients to our server. Why is this a problem? This means you don’t have to redeploy your client to make changes to the implementation, and you don’t have to...
blog.apiary.io
Shellshock Bash Security—Apiary Blog
https://blog.apiary.io/2014/10/07/Shell-Shock-Security
The recent announcement of the Shellshock bug CVE-2014-6271. Had raised concerns about security of customer data. At Apiary, we are pleased to announce that we do not have any GNU Bash-run service. We have also checked all our service providers who have anything to do with customer data and have confirmed that neither of them run any service by GNU Bash. Therefore, we are sure that there is no security flaw to be exploited in our system. Apart from that, we have also updated all local. You can Read more.
blog.apiary.io
Interact with Apiary from the Command Line—Apiary Blog
https://blog.apiary.io/2014/11/05/Interact-with-Apiary-from-the-Command-Line
Interact with Apiary from the Command Line. We thought we’d put together a blog post to highlight another way for you to work with Apiary, and that is through using our Apiary CLI tool. Everyone has their own workflow, and sometimes that workflow involves their favorite editor and the command line. This Apiary CLI tool can allow you to stay in that workflow while interacting directly with Apiary through our API. With the Apiary CLI tool, you can preview. Apiary preview - server. Apiary fetch - api-name =.
SOCIAL ENGAGEMENT