目前，我们的API中的关系用主键表示。在本教程的这一部分中，我们将改进API的内聚力和可发现性，而不是使用关联的超链接。
现在我们有‘snippets‘和‘users‘的端点，但是我们的API没有一个入口点。为了创建一个入口点，我们将使用一个常规的基于函数的视图和我们之前介绍的装饰器@api_view。在你的snippets/views.py添加：
from rest_framework.decorators import api_view from rest_framework.response import Response from rest_framework.reverse import reverse @api_view([‘GET‘]) def api_root(request, format=None): return Response({ ‘users‘: reverse(‘user-list‘, request=request, format=format), ‘snippets‘: reverse(‘snippet-list‘, request=request, format=format) })
这里应该注意两件事。首先，我们使用REST框架的reverse函数来返回完全限定的URLs; 第二，URL模式是通过方便的名字来标识的，我们稍后会在snippets/urls.py中声明。
我们的pastebin API中仍然缺少的另一个明显的事情是 the code highlighting endpoints。
与所有其他API端点不同，我们不想使用JSON，而只是呈现HTML表现层。REST框架提供了两种HTML渲染器样式，一种是使用模板来解决HTML渲染，另一种使用预渲染的HTML。第二个渲染器是我们要用于此端点的渲染器。
在创建代码高亮视图时，我们需要考虑的另一件事是，没有现成的具体通用视图让我们使用。我们不返回一个对象实例，而是返回一个对象实例的属性。
我们不是使用具体的通用视图，而是使用基类来表示实例，并创建我们自己的.get()方法。在你的snippets/views.py添加：
from rest_framework import renderers from rest_framework.response import Response class SnippetHighlight(generics.GenericAPIView): queryset = Snippet.objects.all() renderer_classes = (renderers.StaticHTMLRenderer,) def get(self, request, *args, **kwargs): snippet = self.get_object() return Response(snippet.highlighted)
像往常一样，我们需要在URLconf中添加新视图。我们将在snippets/urls.py中为我们的新API根添加一个url模式:
url(r‘^$‘, views.api_root),
然后为 snippet highlights添加一个url模式：
url(r‘^snippets/(?P<pk>[0-9]+)/highlight/$‘, views.SnippetHighlight.as_view()),
处理entities之间的关系是Web API设计中更具挑战性的方面之一。我们可以选择一些不同的方式来代表一种关系：
使用主键。
在实体之间使用超链接。
在相关实体上使用唯一的标识字段。
使用相关实体的默认字符串表示形式。
将相关实体嵌套在父表示内。
一些其他自定义表示。
REST框架支持所有这些样式，并且可以将它们应用于正向或反向关系，也可以在诸如通用外键之类的自定义管理器上应用。
在这种情况下，我们希望在实体之间使用超链接样式。为了这样做，，我们将修改我们的序列化程序来扩展HyperlinkedModelSerializer而不是现有的ModelSerializer。
HyperlinkedModelSerializer与ModelSerializer有以下区别:
默认情况下不包括id字段。
它包括一个使用HyperlinkedIdentityField的url字段。
关系使用HyperlinkedRelatedField，而不是PrimaryKeyRelatedField。
我们可以使用超链接轻松地重写我们现有的序列化程序。在你的snippets/serializers.py添加：
class SnippetSerializer(serializers.HyperlinkedModelSerializer): owner = serializers.ReadOnlyField(source=‘owner.username‘) highlight = serializers.HyperlinkedIdentityField(view_name=‘snippet-highlight‘, format=‘html‘) class Meta: model = Snippet fields = (‘url‘, ‘id‘, ‘highlight‘, ‘owner‘, ‘title‘, ‘code‘, ‘linenos‘, ‘language‘, ‘style‘) class UserSerializer(serializers.HyperlinkedModelSerializer): snippets = serializers.HyperlinkedRelatedField(many=True, view_name=‘snippet-detail‘, read_only=True) class Meta: model = User fields = (‘url‘, ‘id‘, ‘username‘, ‘snippets‘)
请注意，我们还添加了一个新的‘highlight‘字段。该字段与url字段具有相同的类型，除了它指向‘snippet-highlight‘url模式，而不是‘snippet-detail‘url模式。
因为我们包括格式后缀的URL ‘.json‘，所以我们还需要在highlight字段上指出，返回的任何格式后缀的超链接都应该使用‘.html‘后缀。
如果我们要使用超链接类型的API，那么我们需要命名URL模式。我们来看看我们需要命名的URL模式。
我们的API的根源是指‘user-list‘和‘snippet-list‘。
我们的片段serializer包括一个引用‘snippet-highlight‘的字段。
我们的用户serializer包括一个引用‘snippet-detail‘的字段。