the-grid / apidocs

API documentation for The Grid
https://developer.thegrid.io
44 stars 9 forks source link

where/how to save user-defined focus rect #52

Open forresto opened 8 years ago

forresto commented 8 years ago

I don't see block.cover documented http://developer.thegrid.io/api.html#content-management-item

Is there a key for faces + saliency bbox, or do I need to derive that? @automata

I need to decide where/how to save user-defined focus rectangle

forresto commented 8 years ago

Is cover.scene (data helper stuff) saved to block or calculated by DS? (Ed's fixture is old.)

automata commented 8 years ago

block.cover is documented in https://github.com/the-grid/apidocs/blob/gh-pages/full-schema/media.json#L10 (we should probably put links on developer.thegrid.io for those full schemas).

cover.scene groups faces and saliency bbox and is calculated by data-helper and must be called by DS or other The Grid's API consumer. It is documented in https://github.com/the-grid/apidocs/blob/gh-pages/full-schema/helpermeasurements.json#L7-L41.

I'm OK with block.metadata.coverPrefs.scene. It's data type should follow ☝️ schema.