feat: adapt to v1

Author: null8626

README.md

@@ -2,6 +2,27 @@
 
 The community-maintained PHP library for Top.gg.
 
+## Chapters
+
+- [Installation](#installation)
+- [Setting up](#setting-up)
+- [Usage](#usage)
+  - [API v1](#api-v1)
+    - [Getting your project's vote information of a user](#getting-your-projects-vote-information-of-a-user)
+    - [Posting your bot's application commands list](#posting-your-bots-application-commands-list)
+  - [API v0](#api-v0)
+    - [Getting a bot](#getting-a-bot)
+    - [Getting several bots](#getting-several-bots)
+    - [Getting your project's voters](#getting-your-projects-voters)
+    - [Check if a user has voted for your project](#check-if-a-user-has-voted-for-your-project)
+    - [Getting your bot's statistics](#getting-your-bots-statistics)
+    - [Posting your bot's statistics](#posting-your-bots-statistics)
+    - [Automatically posting your bot's statistics every few minutes](#automatically-posting-your-bots-statistics-every-few-minutes)
+    - [Checking if the weekend vote multiplier is active](#checking-if-the-weekend-vote-multiplier-is-active)
+    - [Generating widget URLs](#generating-widget-urls)
+  - [Webhooks](#webhooks)
+    - [Being notified whenever someone voted for your project](#being-notified-whenever-someone-voted-for-your-project)
+
 ## Installation
 
 ```sh
@@ -10,74 +31,116 @@ $ composer require top-gg/php-sdk
 
 ## Setting up
 
+### API v1
+
+> **NOTE**: API v1 also includes API v0.
+
+```php
+include_once __DIR__ . "/vendor/autoload.php";
+
+use DBL\V1DBL;
+
+$client = new V1DBL([
+  "token" => "Top.gg API token"
+]);
+```
+
+### API v0
+
 ```php
 include_once __DIR__ . "/vendor/autoload.php";
 
 use DBL\DBL;
 
 $client = new DBL([
-  "token" => "Insert your Top.gg API token here."
+  "token" => "Top.gg API token"
 ]);
 ```
 
 ## Usage
 
-### Getting a bot
+### API v1
+
+#### Getting your project's vote information of a user
 
 ```php
-$bot = $client->get_bot();
+$vote = $client->get_vote(661200758510977084);
 ```
 
-### Getting several bots
+#### Posting your bot's application commands list
 
-#### With defaults
+```php
+$client->post_commands([
+  [
+    "options" => [],
+    "name" => "test",
+    "name_localizations" => null,
+    "description" => "command description",
+    "description_localizations" => null,
+    "contexts" => [],
+    "default_permission" => null,
+    "default_member_permissions" => null,
+    "dm_permission" => false,
+    "integration_types" => [],
+    "nsfw" => false
+  ]
+]);
+```
+
+### API v0
+
+#### Getting a bot
 
 ```php
-$bots = $client->get_bots();
+$bot = $client->get_bot(1026525568344264724);
 ```
 
-#### With explicit arguments
+#### Getting several bots
 
 ```php
 //                        Limit  Offset  Sort by
-$bots = $client->get_bots(50,    0,      "date");
+$bots = $client->get_bots(50,    0,      "monthlyPoints");
 ```
 
-### Getting your bot's voters
+#### Getting your project's voters
 
-#### First page
+##### First page
 
 ```php
-$voters = $client->get_voters();
+$voters = $client->get_votes();
 ```
 
-#### Subsequent pages
+##### Subsequent pages
 
 ```php
-$voters = $client->get_voters(2);
+//                           Bot ID (unused)  Page number
+$voters = $client->get_votes(0,               2);
 ```
 
-### Check if a user has voted for your bot
+#### Check if a user has voted for your project
 
 ```php
-$has_voted = $client->has_voted(205680187394752512);
+//                                  Bot ID (unused)  User ID
+$has_voted = $client->get_user_vote(0,               661200758510977084);
 ```
 
-### Getting your bot's server count
+#### Getting your bot's statistics
 
 ```php
-$server_count = $client->get_server_count();
+$stats = $client->get_stats();
 ```
 
-### Posting your bot's server count
+#### Posting your bot's statistics
 
 ```php
-$client->post_server_count($bot->get_server_count());
+$client->post_stats(0, [
+  "server_count" => $bot->get_server_count()
+]);
 ```
 
-### Automatically posting your bot's server count every few minutes
+#### Automatically posting your bot's statistics every few minutes
 
-> **NOTE:** Considering PHP's shortcomings, this is only possible via a URL.
+> **NOTE**: Considering PHP's shortcomings, this is only possible via a URL.
 
 In your original client declaration:
 
@@ -87,21 +150,23 @@ $client = new DBL([
   "auto_stats" => [
     "url": "Your URL",
     "callback": => function () use ($bot) {
-      return $bot->get_server_count();
+      return [
+        "server_count" => $bot->get_server_count()
+      ];
     }
   ]
 ]);
 ```
 
-### Checking if the weekend vote multiplier is active
+#### Checking if the weekend vote multiplier is active
 
 ```php
 $is_weekend = $client->is_weekend();
 ```
 
-### Generating widget URLs
+#### Generating widget URLs
 
-#### Large
+##### Large
 
 ```php
 use DBL\Widget;
@@ -110,7 +175,7 @@ use DBL\WidgetType;
 $widget_url = Widget::large(WidgetType::DiscordBot, 574652751745777665);
 ```
 
-#### Votes
+##### Votes
 
 ```php
 use DBL\Widget;
@@ -119,7 +184,7 @@ use DBL\WidgetType;
 $widget_url = Widget::votes(WidgetType::DiscordBot, 574652751745777665);
 ```
 
-#### Owner
+##### Owner
 
 ```php
 use DBL\Widget;
@@ -128,7 +193,7 @@ use DBL\WidgetType;
 $widget_url = Widget::owner(WidgetType::DiscordBot, 574652751745777665);
 ```
 
-#### Social
+##### Social
 
 ```php
 use DBL\Widget;
@@ -139,7 +204,7 @@ $widget_url = Widget::social(WidgetType::DiscordBot, 574652751745777665);
 
 ### Webhooks
 
-#### Being notified whenever someone voted for your bot
+#### Being notified whenever someone voted for your project
 
 **With Laravel:**
 

main.php

@@ -18,12 +18,61 @@
  */
 
 include_once __DIR__ . "/vendor/autoload.php";
-use DBL\DBL;
-use DBL\API\Http;
+use DBL\V1DBL;
 
 $token = @file_get_contents(".TOKEN");
-$api = new DBL([
+$client = new V1DBL([
   "token" => $token
 ]);
 
+echo "\nrunning get bot:\n";
+$bot = $client->get_bot(1026525568344264724);
+print_r($bot);
+
+echo "\nrunning get bots:\n";
+$bots = $client->get_bots();
+print_r($bots);
+
+echo "\nrunning get votes:\n";
+$voters = $client->get_votes();
+print_r($voters);
+
+echo "\nrunning get user vote:\n";
+$has_voted = $client->get_user_vote(0, 661200758510977084);
+print_r($has_voted);
+
+echo "\nrunning get stats:\n";
+$stats = $client->get_stats();
+print_r($stats);
+
+echo "\nrunning post stats:\n";
+$client->post_stats(0, [
+  "server_count" => 2
+]);
+
+echo "\nrunning is weekend:\n";
+$is_weekend = $client->is_weekend();
+print_r($is_weekend);
+
+echo "\nrunning post commands:\n";
+$client->post_commands([
+  [
+    "options" => [],
+    "name" => "test",
+    "name_localizations" => null,
+    "description" => "command description",
+    "description_localizations" => null,
+    "contexts" => [],
+    "default_permission" => null,
+    "default_member_permissions" => null,
+    "dm_permission" => false,
+    "integration_types" => [],
+    "nsfw" => false
+  ]
+]);
+
+echo "\nrunning get vote:\n";
+$vote = $client->get_vote(661200758510977084);
+print_r($vote);
+
 ?>