Comments (7)
You're absolutely right—we do need a robust, structured definition of a photo. This photo object would make a good starting point for what a well-known photo attachment annotation would look like.
from api-spec.
@jmathai curious if you might give me some feedback on:
https://gist.github.com/3173716
Thanks!
from api-spec.
@berg I like it. A couple questions.
- For the following,
200x200
withcropped: false
means the aspect ratio is maintained? This means the actual dimensions might differ, right? - Are you planning on any concept of tracking what app generated the event or object? Is it feasible to have permissions around that as well? i.e. Only grant app A access to content it creates.
- How do permissions work. At the least, public and private.
- I see a
date
field but what about date taken (from exif) and date created or uploaded?
Possibly a few more but that's enough for now..
from api-spec.
Thanks. Let me respond to your questions in turn:
- With
cropped: false
, the aspect ratio would be maintained, yes. The idea is that the key would reflect the post-crop dimensions.cropped: true
means that the image has been cropped to square (that key could be more accurately named). - There will be a link object on the photo, which will have information about the photo's creator and app, if desired. This will allow for a link back to the canonical location of the image. I left that out because I'm still working on defining this link object.
- This is an annotation on a post. The post itself determines the public/private nature of the image.
- The
date
here is intended to be the date taken—i.e., the date from EXIF tags, given that the post surrounding this image will have its own date.
from api-spec.
That all sounds good to me. Does cropped: true
implying it's a square image? Any reason the aspect ration can't be flexible?
For example..
"200x300": {
"size": 30,
"width": 200,
"height": 300,
"cropped": true,
"rotation": 0,
"url": "http://example.com/photo/200x300.jpg"
},
from api-spec.
cropped: true
is supposed to be an easy way for an stream consumer to find a square thumbnail. Does that make sense?
from api-spec.
It does and it's probably sufficient. I'm coming from the perspective of a pure photo API when I question if the only cropped ratio should be square.
Just bringing that up in the event you forsee API developers wanting a specific size that's not a square. The way it is now your only options are to get a square or whatever the original aspect ratio is. If that's okay, then I think what you have proposed is good.
from api-spec.
Related Issues (20)
- Modifying annotations on an existing file doesn't seem to trigger a user stream event HOT 1
- Add "Mentions" to a User's Counts object
- Feature Request: Report Wrong Account Type Endpoint HOT 6
- The documentation for creating a file is incomplete
- Add a way to get messages in a channel containing a hashtag
- Add starring functionality to Messages HOT 1
- Abstract away stars – support generic "actions" with associated counters
- Post Search docs mentions seemingly non-functional has_location parameter HOT 6
- More Stream Faceting parameters HOT 1
- Dead link on the Messaging Basics page HOT 1
- Posts API : Reposts? HOT 3
- Expose which posts/messages a file has been attached to/embedded in HOT 1
- Feature request: Reply to multiple posts HOT 1
- Bug in Interactions endpoint pagination when using interaction_actions without "reply" HOT 5
- Allow searching for posts in the users stream.
- Annotations are not returned when creating a channel HOT 3
- include_inactive ignored by https://api.app.net/channels?ids=… HOT 2
- Wikipedia Markdown link throws a 'Bad request' error HOT 1
- User streaming - Add post hashtag search HOT 1
- Streaming fails to recognise "Upgrade: WebSocket" case insensitive
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-spec.