Add API for Retrieving All Documents

[devleejb]

Description:

Proposing the addition of a REST API to retrieve the contents of Yorkie Documents, enabling developers using Yorkie to utilize the data.

Why:

During the operation of our service, the need for data analysis, such as inspecting accumulated data in Yorkie Documents, has arisen.

[krapie]

Currently, there is an GetDocumentSummary() admin gRPC API for getting a snapshot of a document.
Are you suggesting an HTTP REST API in JSON format to get document snapshots?

[devleejb]

Exactly. I think I need an HTTP REST API. The service data is needed more for data analysis rather than in real-time, and gRPC has significant technical overhead.

[hackerwins]

@krapie I remember connect-rpc also exposing the APIs in HTTP as well as gRPC. Am I right?

• https://connectrpc.com/
• Research connect-rpc #668

[krapie]

@hackerwins Yes, connect-rpc also exposes plain HTTP along with gRPC. I think we can also resolve this issue when we switch current server rpc to connect-rpc.

[hackerwins]

Great. We will soon be using Secret Key for the Admin API too.

[krapie]

I have confirmed that we can use ConnectRPC to retrieve document with HTTP POST

Very excited to see this working :)

[hackerwins]

After migrating to Connect RPC, we can use REST API.

I think this issue could be solved by using the Private Key created in the Dashboard during the authentication step.

yorkie/server/rpc/auth/auth.go

Lines 46 to 61 in 258cb1e

	func VerifyAccess(ctx context.Context, be *backend.Backend, accessInfo *types.AccessInfo) error {
	md := metadata.From(ctx)
	project := projects.From(ctx)
	if !project.RequireAuth(accessInfo.Method) {
	return nil
	}
	return verifyAccess(
	ctx,
	be,
	project.AuthWebhookURL,
	md.Authorization,
	accessInfo,
	)
	}

[devleejb]

Then, is it possible to provide API for other features? (Document Editing, ...)