Comments (4)
JSONAPI pretty much cover most of this specification. Have you take a look at it?
from api-standards.
I've seen it, though it doesn't seem that recently updated, or commonly used. I think Hypermedia (like REST) is more of an approach than a specific standard.
from api-standards.
Would be interested to know if this picture at 18F has evolved around use of hypermedia APIs?
Also has anyone looked at http://www.hydra-cg.com/ ?
from api-standards.
This may be a broader issue, but I think there's a place for this repo to have a more opinionated preference on specific API standards. (It is called "API Standards" after all, not 'guidance' or 'principles'.) IMHO, the right balance could be having a spec and reference implementation(s), perhaps starting with JSONAPI.
The idea would not be a mandate to all, but rather a more concrete starting point to address: "I'm going to build an API for an agency. I don't have a particularly unique need or strong opinion. Just give me a straightforward starting point." Perhaps the answer is to use the JSONAPI spec, and for gov APIs include at least these meta data fields, perhaps aligned with common core metadata.
from api-standards.
Related Issues (20)
- Coordinate with 18F team owners HOT 1
- Standard length of time provided for deprecation, changes? HOT 1
- "Don't use unpredictable keys" (in response JSON) HOT 1
- Possibly include link header in pagination section? HOT 3
- Specify date format standard HOT 5
- under_score for JSON keys? HOT 6
- avoid using "entropy"
- for discussion: HTTPS everywhere HOT 1
- expand acceptable input param vehicles to include full URIs
- What data should go in headers, and what data in the response body HOT 14
- Stacktraces in production HOT 1
- New APIs should require SNI of their users
- Request to change description to make it clearer for users HOT 4
- Data envelopes and format of `results` attribute HOT 3
- This repo should be converted to 18F Pages HOT 9
- Shouldn't this repo have a LICENSE? HOT 2
- Singluar vs. Plural Nouns HOT 1
- Justify use of charset parameter in JSON payloads HOT 2
- FBOpen links returning a 404 HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
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.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from api-standards.