From 42d95bdc14a887c37ec1f849d0f8224736816f11 Mon Sep 17 00:00:00 2001 From: Yorhel Date: Sun, 15 Nov 2009 10:06:05 +0100 Subject: d11: Misc. improvements and typo fixes --- data/docs/11 | 41 ++++++++++++++++++----------------------- 1 file changed, 18 insertions(+), 23 deletions(-) (limited to 'data/docs') diff --git a/data/docs/11 b/data/docs/11 index 199935fd..e1e49881 100644 --- a/data/docs/11 +++ b/data/docs/11 @@ -4,8 +4,8 @@ :SUB:Introduction

This document describes the public API of VNDB and is intended to be read by - programmers. The API allows programs and websites to access (parts of) the VNDB - database without actually visiting a page on the website. + programmers. This API allows programs and websites to access (parts of) the + VNDB database without actually visiting the website.

@@ -14,16 +14,11 @@
  • Simple in implementation of both client and server. "Simple" here means that it shouldn't take much code to write a secure and full implementation and that - client applications don't require huge dependency trees just to use this API. + client applications shouldn't require huge dependency trees just to use this API.
  • Powerful: Not as powerful as raw SQL, but not as rigid as commonly used REST or RPC protocols.
    • -
  • Fast: minimal bandwidth overhead
    • -
  • - High-level: nobody is interested in the internal database structure of VNDB - (ok, maybe you are, but you wouldn't want to write an application using it: it - changes quite often) -
    • -
  • Stateful
    • +
  • High-level: common applications need to perform only few actions to get what they want.
    • +
  • Fast: minimal bandwidth overhead and simple and customizable queries.

    • @@ -45,8 +40,7 @@ server resources and prevent abuse of this service.


    @@ -82,9 +77,9 @@ server resources and prevent abuse of this service.

  • This service does not grant anyone the right to copy or republish the information fetched using the API. VNDB does not have a clear copyright - statement, and in general we're not very strict about other people copying our - information, but this API is not intended to be used fetching and publishing - half of our database. When in doubt, ask. + statement, and in general we're not very strict about other people copying + our information, but this API is not intended to be used for fetching and + publishing more than half of our database. When in doubt, ask.
  • Lastly, this API is not complete. If you have any specific features you'd @@ -106,12 +101,12 @@ server resources and prevent abuse of this service.

    returned, it may very well happen that this is later changed into an array. Make sure your application doesn't completely crash in such an event. Also keep in mind that for every command you send, the server can reply with an error, or - can immediately close the connection (but this is be rare). + can immediately close the connection (but this should be rare).
  • Regularly check this page to see if anything has changed to the API, and - update your client where necessary. I'll probably add a changelog to the bottom - of this page to make this easier. + update your client when necessary. I'll probably add a changelog to the bottom + of this page in the future.
  • Use a JSON library for both encoding and decoding JSON data. While the format @@ -130,7 +125,7 @@ server resources and prevent abuse of this service.

    for the glory details.

    The words object, array, value, string, - number and int refer to the JSON data types. In addition the following + number and integer refer to the JSON data types. In addition the following definitions are used in this document:

    @@ -183,7 +178,7 @@ however still required.

    Some commands accept a filter string as argument. This argument is formatted similar to boolean expressions in most programming languages. A filter consists - of one or more expressions, separated by the boolean operators "and" and + of one or more expressions, separated by the boolean operators "and" or "or" (lowercase). Each filter expression can be surrounded by parentheses to indicate precedence, the filter argument itself must be surrounded by parentheses.
    @@ -205,7 +200,7 @@ however still required.
    title ~ "osananajimi" ) -

    More complex things are also possible:

    +

    More complex filters are also possible:

      ((platforms = ["win", "ps2"] or languages = "ja") and released > "2009-01-10")
    @@ -238,10 +233,10 @@ however still required.
    :SUB:The 'get' command

    - This command is used to fetch data from the database. It accepts 3 arguments: + This command is used to fetch data from the database. It accepts 4 arguments: the type of data to fetch (e.g. visual novels or producers), what part of that data to fetch (e.g. only the VN titles, or the descriptions and relations as - well), and lastly a filter expression. + well), a filter expression, and lastly some options. 

      get type flags filters options
-- 
cgit v1.2.3