Skip to content

Instantly share code, notes, and snippets.

@laser
Last active August 29, 2015 14:21
Show Gist options
  • Save laser/18c9f27c54f25acbf112 to your computer and use it in GitHub Desktop.
Save laser/18c9f27c54f25acbf112 to your computer and use it in GitHub Desktop.
Mobile API Contracts

Mobile Search

Q: When someone performs a "search video title" - what kind of information should they expect to get back? The designs show: thumbnail, video title, video alternate title (implicit: video id and...?). A:

Q: If I search for "fast" and I have a video with the title "Great Trailer" and alternative title "Great Trailer Alt" and is associated with movie "Fast and Furious" - does that video show up in my search results?

Q: Should the API consumer be able to provide a value indicating the maximum number of search results to return? A:

Buy Movie Links

Q: Does a movie have a "buy link" - or a video? A:

Buy Link Associated w/Movie

Q: Can the movie have more than one "buy link"? e.g. Director's Cut / BlueRay / LaserDisc / VHS A:

Q: What determines the sort order of the "buy link"s? A:

Q: If a video is associated with multiple movies and each movie has its own "buy link"s, how do we know what to show in the UI? A:

Buy Link Associated w/Video

Q: Can the movie have more than one "buy link"? e.g. Director's Cut / BlueRay / LaserDisc / VHS A:

Q: What determines the sort order of the "buy link"s? A:

Link to Android bumper here

Tag Expansion

Q: What story is driving this API's development? A:

Q: Does the Tagging Service currently allow multi-GETs, e.g. GET /tags?ids=1,2,3,4? A:

Video Classification

Q: Can I simply add a "classification" to each video coming back from the Video Service of type ENUM("Class 1", "Class 2", "Class 3")? A:

Q: Who is responsible for doing the work to expose this information through the Video Service? me? A:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment