kinlane / api-evangelist Goto Github PK

It's currently going to https://github.com/va-data/va-developer.

Case:

• Post "Building the Perfect API Stack, 19 July, 2011" in https://apievangelist.com/archive/ is not clickable.

Cause:

• some posts use "source" while others use "url"

Solution:

• handle both so all posts are clickable

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

Many URLs point to http://blog.apievangelist.com and result in an error
removing the "blog." and the URL works.

Solution:

• create the subdomain to keep old traffic
• run a search and replace on all post files

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]

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. :)

Hey, noticed that there's a Github fork ribbon was different (black instead of red) on http://history.apievangelist.com/ , also the link appears to be broken

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

Bonus points for deleting the master branch as well. 😸

apievangelist.com

I'm not sure how it works, though @benbalter could say - check it out though.

project-open-data/project-open-data.github.io#250

It's pretty powerful and would likely be a good tool to integrate here.