v2 API returns far fewer fields as compared to v1

[khilnani]

There seems to be several differences between the amount of data returned by v2 vs. v1.

Example -

• http://readthedocs.org/api/v1/project/13/?format=json returns several fields, including the file download urls.
• http://readthedocs.org/api/v2/project/13/?format=json has very few fields to make it usable.

Given #1610, which is the API version recommended for public use, and is there any timeline for v2?

Version 1

{
"absolute_url": "/projects/pip/",
"allow_comments": false,
"analytics_code": "",
"canonical_url": "https://pip.pypa.io/",
"cdn_enabled": false,
"comment_moderation": false,
"conf_py_file": "",
"copyright": "2008-2011, The pip developers",
"default_branch": "master",
"default_version": "stable",
"description": "Pip Installs Packages. ",
"django_packages_url": "",
"documentation_type": "sphinx",
"downloads": {
"epub": "//readthedocs.org/projects/pip/downloads/epub/stable/",
"htmlzip": "//readthedocs.org/projects/pip/downloads/htmlzip/stable/",
"pdf": "//readthedocs.org/projects/pip/downloads/pdf/stable/"
},
"enable_epub_build": true,
"enable_pdf_build": true,
"id": 13,
"language": "en",
"mirror": false,
"modified_date": "2015-05-09T13:42:51.151243",
"name": "pip",
"num_major": 1,
"num_minor": 1,
"num_point": 1,
"privacy_level": "public",
"project_url": "https://pip.pypa.io/",
"pub_date": "2010-08-16T03:43:45.786781",
"python_interpreter": "python",
"repo": "git://github.com/pypa/pip.git",
"repo_type": "git",
"requirements_file": "",
"resource_uri": "/api/v1/project/13/",
"single_version": false,
"skip": false,
"slug": "pip",
"subdomain": "http://pip.readthedocs.org/",
"suffix": ".txt",
"theme": "nature",
"use_system_packages": false,
"use_virtualenv": true,
"users": [
"/api/v1/user/7583/",
"/api/v1/user/1335/",
"/api/v1/user/11/",
"/api/v1/user/1017/"
],
"version": "",
"version_privacy_level": "public"
}

Version 2

{
"id": 13,
"name": "pip",
"slug": "pip",
"description": "Pip Installs Packages. ",
"language": "en",
"repo": "git://github.com/pypa/pip.git",
"repo_type": "git",
"default_version": "stable",
"default_branch": "master",
"documentation_type": "sphinx",
"users": [
7583,
1335,
11,
1017
]
}

[agjohnson]

There isn't meant to be parity between our APIs in general, though as we move over to using APIv2 exclusively, we'll need to address these issues. We're slowly deprecating our v1 API, but in the meantime, that should be used until we have a solid v2 API

[khilnani]

Thanks for including in APIv2.1

[stsewd]

We are now planning v3 #4286, v2 will not be continued. Feel free to make suggestions in the other issue.