Git Product home page Git Product logo

api-evangelist's Introduction

API Evangelist

This is my blog for making sense of the technology, business, and politics of APIs. It all runs here on Github, so feel free to submit any pull requests of changes you'd like to see.

api-evangelist's People

Contributors

apievangelist avatar apireview avatar arifc avatar arno-di-loreto avatar audreywatters avatar benjackwhite avatar carlmungazi avatar dasevilla avatar earth2marsh avatar gbinal avatar hbt avatar jarz avatar jeremiak avatar johnsheehan avatar kinlane avatar konklone avatar kulnor avatar mgboydcom avatar timmmmyboy avatar ws avatar xrysanthos avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

api-evangelist's Issues

Use ISO 8601 dates for the "Posted on" line in the blog

API Evangelist blog post dates are in MM-DD-YYYY format, which can be ambiguous when reading 04-03-2014.

ISO 8601 is a universal interchange format and is popular in APIs, so it seems like a natural fit for an API blog. :)

Swagger Validation Errors

Hello Kin,

I've been going through the Swagger definitions on http://theapistack.com/just-swagger.html to try find some that I could set up as remote web services on DreamFactory to use as examples. When I paste your Swagger files in to get validated or to import on the swagger.io editor they all turn up some errors. I was wondering if you have an insight as to what might be the case.

Here's an example:

Pasting the file from API Evangelist - http://theapistack.com/data/api-evangelist/api-evangelist-tools-api-swagger.json into http://bigstickcarpet.com/swagger-parser/www/index.html yields the error messages below. Pasting the file into http://editor.swagger.io/#/ via 'Paste JSON' also generates errors.

I'm sure you're super busy and this is probably user-error on my side, but if you have a suggestion I'm all ears. I'd also love to contribute defining some of the Swagger APIs that you would like to develop / list in your project once I get up to speed.

http://bigstickcarpet.com/swagger-parser/www/index.html OUTPUT =>

Swagger schema validation failed.
Data does not match any schemas from 'oneOf' at #/paths//tool/{id}/get/parameters/2
Data does not match any schemas from 'oneOf' at #/paths//tool/{id}/get/parameters/2
Missing required property: schema at #/
Data does not match any schemas from 'oneOf' at #/
No enum match for: path at #/in
No enum match for: path at #/in
No enum match for: path at #/in
Missing required property: required at #/
Missing required property: $ref at #/paths//tool/{id}/get/parameters/2

JSON_OBJECT_VALIDATION_FAILED

Error: Swagger schema validation failed.
Data does not match any schemas from 'oneOf' at #/paths//tool/{id}/get/parameters/2
Data does not match any schemas from 'oneOf' at #/paths//tool/{id}/get/parameters/2
Missing required property: schema at #/
Data does not match any schemas from 'oneOf' at #/
No enum match for: path at #/in
No enum match for: path at #/in
No enum match for: path at #/in
Missing required property: required at #/
Missing required property: $ref at #/paths//tool/{id}/get/parameters/2

JSON_OBJECT_VALIDATION_FAILED
at http://bigstickcarpet.com/swagger-parser/www/js/bundle.min.js:11:318
at http://bigstickcarpet.com/swagger-parser/www/js/bundle.min.js:50:316

SyntaxError: Swagger schema validation failed.
Data does not match any schemas from 'oneOf' at #/paths//tool/{id}/get/parameters/2
Data does not match any schemas from 'oneOf' at #/paths//tool/{id}/get/parameters/2
Missing required property: schema at #/
Data does not match any schemas from 'oneOf' at #/
No enum match for: path at #/in
No enum match for: path at #/in
No enum match for: path at #/in
Missing required property: required at #/
Missing required property: $ref at #/paths//tool/{id}/get/parameters/2

JSON_OBJECT_VALIDATION_FAILED
at Function.syntax (http://bigstickcarpet.com/swagger-parser/dist/swagger-parser.min.js:284:318)
at validateSchema (http://bigstickcarpet.com/swagger-parser/dist/swagger-parser.min.js:20:254)
at http://bigstickcarpet.com/swagger-parser/dist/swagger-parser.min.js:8:1921

z-schema validation error: JSON_OBJECT_VALIDATION_FAILED
at ZSchema.getLastError (http://bigstickcarpet.com/swagger-parser/dist/swagger-parser.min.js:2047:3479)
at validateSchema (http://bigstickcarpet.com/swagger-parser/dist/swagger-parser.min.js:20:158)
at http://bigstickcarpet.com/swagger-parser/dist/swagger-parser.min.js:8:1921

http://editor.swagger.io/#/ OUTPUT =>

Error
Object
code: "ONE_OF_MISSING"
message: "Not a valid parameter definition"
path: Array [5]
0: "paths"
1: "/tool/{id}"
2: "get"
3: "parameters"
4: "2"
inner: Array [2]

Where to find which apis have Swagger files

Hi Kin,

I'm currently on the prowl for sources of Swagger-providing APIs that I want to make available for browsing/importing into Ritc (especially if they are tagged and/or categorized).

Is there somewhere on apievangelist that I can go for this. Human readable is nice, but I am looking for machine-readable.

Thanks

Colin Goldberg

Set default branch to `gh-pages`

via settings. So visitors to the repo can see the code immediately.

Bonus points for deleting the master branch as well. ๐Ÿ˜ธ

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.