tfredrich / restapitutorial.com Goto Github PK
View Code? Open in Web Editor NEWHTML Source code for www.RestApiTutorial.com
Home Page: http://www.RestApiTutorial.com
License: Creative Commons Attribution Share Alike 4.0 International
HTML Source code for www.RestApiTutorial.com
Home Page: http://www.RestApiTutorial.com
License: Creative Commons Attribution Share Alike 4.0 International
In the quicktips you describe status 405 as an example for POST. In the HTTP methods 405 is not described as possible return status for a POST.
Have you thought about dark mode? I haven't dig into the source code and I don't know for sure if it's gonna take too much.
Thoughts?
All too often, GET, POST, PUT, and DELETE are the only verbs discussed. Might it be worth adding some of the others, such as HEAD, OPTIONS, and PATCH?
Links and the Menu-links to this page:
http://www.restapitutorial.com/lessons/restquicktips.html
Where you get a message that it has been moved, to itself...
This doc is amazing, it deserves a portuguese doc! Right?
Is there someone here to accept a pull request that I'll do?
This is my proposal.
Maybe add this statuscode to your awesome website? :-)
http://tools.ietf.org/html/draft-tbray-http-legally-restricted-status-00
Is this web site automatically generated or is it manually crafted? what template engines is used etc. I want to create a website like this but I don't want to create everything from scratch.
I've been referencing https://www.restapitutorial.com/httpstatuscodes for a long time now due to the fact that it's shown all HTTP status codes in an overview you have not needed to scroll:
This has been a great strength compared to Wikipedia or IETF which the page references
After the redesign I suddenly have to scroll and it's hard to get just a quick overview, would it be possible to add a quick reference sheet/cheat-sheet again?
Hey
I've found at least two limitations in the pluralization of nouns in web services:
Singularization wouldn't help. Moreover, using a plural form or a singular form doesn't tell you whether your collections allow duplicate elements. That's why I prefer using this kind of perfectible solution:
GET http://www.example.com/customerSet/33245/orderSet/8769/lineitemSet/1
Note that the second limitation can harm when designing automatic test procedures to ensure that all web services work except if the plural forms are used everywhere in your code, both in your database tables and in your classes. Would you really create a class named "Customers with an object oriented programming language?
The 405 is discussed in two places: httpstatuscodes and restquicktips. It would be better to refer to one description or use the same (partial) text. It's a bit confusing with two different descriptions.
Any there any plans to translate web-site into other languages?
I was wondering if there were any guidelines on parameter arrays in a REST api call.
Eg I want to pass an array of id's to get a list of parameters. Two possible implementations:
GET /api/parameters/[1,2,3,4]
or
GET /api/parameters/ids[]=1&ids[]=2&ids[]=3&ids[]=4
My corporate firewall blocks https://d7im4lln3lvbg.cloudfront.net. Can you switch to another CDN, such as https://www.bootstrapcdn.com/ ?
Thank you for your consideration.
When opening the httpmethods page, the "more detailed" discussion shows the GET, but the POST header is selected.
Contradicting information in one of the page, not sure if it's the right place to post this.
Mozilla source :
https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT#example
Please need confirmation if you can.
I checked multiple site and got contradicting answers.
Thanks
Hi,
First of all, I want to say that RestApiTutorial.com is really cool, it expresses the REST API principles in a very clear way and I have learned a lot of REST from it. And I think the site will be even better if some industry practice of REST be included (sometimes is still hard for developers to directly design a REST API only following the principles)
I'd like to recommend adding OData to the website. Below are basic information of OData.
I definitely DON'T mean to make your site to become another an odata.org site. But I think adding a link in the RestApiTutorial.com or even a separate page with introduction to OData can help developers easily pick up a good and verified practice of REST and start their work directly (since OData has a lot of existing libraries).
On page http://www.restapitutorial.com/resources.html there is a link to https://github.com/tfredrich/RestApiTutorial.com/raw/master/media/RESTful_Best_Practices_v1_2.mobi, which is unaccessible.
In:
RestApiTutorial.com / lessons / idempotency.html
Lines 78-82 are duplicates of 68-71, and don't describe Safety.
Show to the users some softwares that provide a rest api design editor like Rational Software Architect
Hi,
I wonder if it'd be useful for RestApiTutorial.com visitors to reference OData related information in its Resource page.
OData is the short for the Open Data Protocol. It's a open industry standard approved by OASIS (ref: https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=odata). It provides specifications and guidelines about how to build and consume REST APIs (URL conventions, behavioral specifications, schema exposure, control information exposure, etc.).
It represents industry practices as Microsoft, SAP, Salesforce, IBM and etc. are all adopting OData as their REST API guidelines.
For more info about it you may refer to http://www.odata.org/.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.