技术人员到此集结 -- 关于创建首个 repo

[DigitalPlatform]

欢迎各位技术人员。

在这里我们讨论一下如何创建首个 repo 的相关事宜，和一些能想到的相关话题。

** 话题1 创建一个 repository 把 API 设计工作实际开展起来

初步设想，是在 GitHub 上的本组织(ApiForum)之下创建一个或者多个 repository。
用开发软件服务器模块的方式，先期开发一个空壳的 Server，目的主要是把 API 接口设计好，并利用某些标注技术，让开发工具自动创建 Swagger 文件并发布出来。这样各家软件商的开发人员可以利用这套 Swagger 文件尝试实现 Client 和 Server 侧的接口，为联调测试创造条件。

我想了解一下：

1. 各位平时都习惯使用哪个开源代码托管平台？平时访问 GitHub 是不是有(网络)困难，需要使用国内的代替 GitHub 的平台么？
2. 对于开放 API，各位都使用过 Swagger 么？(又名 OpenAPI Specification)
3. 各位平时主要使用什么编程语言？

也欢迎就相关的其它细节进行讨论。

** 话题2 先期实现的 API 功能

王馆长提到现在急需实现的 API，主要是权限认证的和 OPAC 需要的一些 API。OPAC 功能首先是一些检索和浏览数据的功能。我下面说一下检索功能。
个人感觉国外的 SRU 协议已经被很多软件使用了，因为是从继承 Z39.50 过来的，功能应该还是比较全面的。是否可以我们这次 API 合作直接采纳 SRU 协议就可以了，不必另外从头发明这部分 API。
当然，“采纳”说起来简单，实际要做的工作还是比较多的：

1. 各位都要学习一下这个协议的用法；
2. 我们要在开发模型服务器的时候，实现 SRU 这部分 Server 的功能；
3. 最好也开发和提供一个模型的 Client 端实现利用这部分 API 的检索界面。
4. 自然语言的 API 文档里面写这部分 API 的格式和用法，和其它功能一样。也就是说，并不是文档里面空缺、然后用一个 URL 让人去直接读国会图书馆上面的文档 (不过我们的文档如果是翻译 SRU 英文版的话可能有个书面征求对方同意的手续，避免违反知识产权规则)

[renyh]

test