{"id":17797425,"url":"https://github.com/edsonmsouza/apigames","last_synced_at":"2025-07-18T13:41:30.044Z","repository":{"id":65949859,"uuid":"584245981","full_name":"EdsonMSouza/apigames","owner":"EdsonMSouza","description":"API para trabalhar com criação de usuários e mantenimento de placares de jogos, principalmente para GODOT.","archived":false,"fork":false,"pushed_at":"2023-01-02T01:26:31.000Z","size":17,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-27T12:24:20.323Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EdsonMSouza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2023-01-02T01:20:12.000Z","updated_at":"2023-05-09T18:21:38.000Z","dependencies_parsed_at":"2023-02-18T00:25:14.446Z","dependency_job_id":null,"html_url":"https://github.com/EdsonMSouza/apigames","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdsonMSouza%2Fapigames","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdsonMSouza%2Fapigames/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdsonMSouza%2Fapigames/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdsonMSouza%2Fapigames/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EdsonMSouza","download_url":"https://codeload.github.com/EdsonMSouza/apigames/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229743831,"owners_count":18117460,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-27T11:55:48.694Z","updated_at":"2024-12-14T19:10:14.793Z","avatar_url":"https://github.com/EdsonMSouza.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PHP API GAMES v.1.0\n\n\u003ccode\u003e\u003cimg height=\"50\" src=\"https://raw.githubusercontent.com/github/explore/80688e429a7d4ef2fca1e82350fe8e3517d3494d/topics/php/php.png\"\u003e\u003c/code\u003e\n\u003ccode\u003e\u003cimg height=\"50\" src=\"https://raw.githubusercontent.com/github/explore/80688e429a7d4ef2fca1e82350fe8e3517d3494d/topics/mysql/mysql.png\"\u003e\u003c/code\u003e\n\nAPI simples para integração com jogos digitais, por exemplo Godot. Ela apresenta recursos para criação de usuário, login, criação de instância de jogos, salvamento, placar e ranking.\n \n```html\nPHP 7.4.3 (cli) (built: Jul  5 2021 15:13:35) ( NTS )\nCopyright (c) The PHP Group Zend Engine v3.4.0, \nCopyright (c) Zend Technologies with Zend OPcache v7.4.3, \nCopyright (c), by Zend Technologies\n```\n\n## Como usar esse conteúdo?\n\nEste conteúdo é livre para uso e distribuição sob a licença (CC BY-SA 4.0).\n\nSe quiser colaborar neste repositório com melhorias ou correções, basta fazer um _fork_ e enviar um PR.\n\n## Estrutura da API\n\n```text\n+---api\n    \\class\\\n        GameModel.php\n        PDOConnection.php\n        UserModel.php\n    game.php\n    scripts.sql\n    teste.httpd\n    user.php\n```\n\n## _Database_\n\nEsta API utiliza o banco de dados MySQL 5, que pode ser alterado a qualquer momento de acordo com a necessidade de uso. O banco de dados deve ser\nconfigurado em _\\class\\PDOConnection.php_.\n\n### Scripts SQL\n\n```sql\nCREATE DATABASE name;\n```\n\n```sql\nCREATE TABLE users\n(\n    id INT(11) NOT NULL PRIMARY KEY AUTO_INCREMENT,\n    name VARCHAR(100) NOT NULL,\n    user  VARCHAR(100) NOT NULL,\n    password  VARCHAR(100) NOT NULL\n);\n\nCREATE TABLE games\n(\n    id INT(11) NOT NULL PRIMARY KEY AUTO_INCREMENT,\n    user_id INT(11),\n    score INT(11)\n);\n```\n\n## _Resources_\n\n### User\n\n| Resource |      URI      |  Method  |\n|:--------:|:-------------:|:--------:|\n|  **NEW** | `http://URI/api/user.php` | **POST** |\n\n_**header**_\n\n```json\n{\n  \"content-type\": \"application/json\"\n}\n```\n\n_**payload**_\n\n```json\n{\n  \"type\": \"new\",\n  \"name\": \"name\",\n  \"user\": \"username\",\n  \"password\": \"password\"\n}\n```\n\n_**Success**_\n\n```json\n{\n  \"data\": \"ok\",\n  \"value\": \"user_created_successfully\"\n}\n```\n\n_**Warnings**_\n\n```json\n{\n  \"data\": \"err\",\n  \"value\": \"invalid_data\"\n}\n```\n\n```json\n{\n  \"data\": \"err\",\n  \"value\": \"user_[...]_exists\"\n}\n```\n\n---\n\n| Resource |      URI      |  Method  |\n|:--------:|:-------------:|:--------:|\n|  **LOGIN** | `http://URI/api/user.php` | **POST** |\n\n_**header**_\n\n```json\n{\n  \"content-type\": \"application/json\"\n}\n```\n\n_**payload**_\n\n```json\n{\n  \"type\": \"login\",\n  \"user\": \"username\",\n  \"password\": \"password\"\n}\n```\n\n_**Success**_\n\n```json\n{\n  \"id\": 5,\n  \"user\": \"username\",\n  \"name\": \"name\",\n  \"data\": \"ok\"\n}\n```\n\n_**Warnings**_\n\n```json\n{\n  \"data\": \"err\",\n  \"value\": \"invalid_data\"\n}\n```\n\n```json\n{\n  \"data\": \"err\",\n  \"value\": \"user_not_found\"\n}\n```\n\n---\n\n| Resource |      URI      |  Method  |\n|:--------:|:-------------:|:--------:|\n|  **USERS** | `http://URI/api/user.php` | **POST** |\n\n_**header**_\n\n```json\n{\n  \"content-type\": \"application/json\"\n}\n```\n\n_**payload**_\n\n```json\n{\n  \"type\": \"users\"\n}\n```\n\n_**Success**_\n\n```json\n{\n  \"0\": {\n    \"user\": \"name\"\n  },\n  \"1\": {\n    \"user\": \"name\"\n  },\n  \"data\": \"ok\"\n}\n```\n\n_**Warnings**_\n\n```json\n{\n  \"data\": \"err\",\n  \"value\": \"invalid_data\"\n}\n```\n\n```json\n{\n  \"data\": \"err\",\n  \"value\": \"there_are_no_users_to_list\"\n}\n```\n\n### Game\n\n| Resource |      URI      |  Method  |\n|:--------:|:-------------:|:--------:|\n|  **NEW** | `http://URI/api/game.php` | **POST** |\n\n_**header**_\n\n```json\n{\n  \"content-type\": \"application/json\"\n}\n```\n\n_**payload**_\n\n```json\n{\n  \"type\": \"new\",\n  \"user_id\": \"value\"\n}\n```\n\n| Resource |      URI      |  Method  |\n|:--------:|:-------------:|:--------:|\n|  **SAVE** | `http://URI/api/game.php` | **POST** |\n\n```json\n{\n  \"content-type\": \"application/json\"\n}\n```\n\n_**Payload**_\n\n```json\n{\n\"type\":\"save\",\n\"game_id\":value,\n\"score\":3000\n}\n```\n\n| Resource |      URI      |  Method  |\n|:--------:|:-------------:|:--------:|\n|  **RANKING GENERAL** | `http://URI/api/game.php` | **POST** |\n\n```json\n{\n  \"content-type\": \"application/json\"\n}\n```\n\n```json\n{\n\"type\":\"ranking_general\"\n}\n```\n\n| Resource |      URI      |  Method  |\n|:--------:|:-------------:|:--------:|\n|  **RANKING USER** | `http://URI/api/game.php` | **POST** |\n\n```json\n{\n  \"content-type\": \"application/json\"\n}\n```\n\n```json\n{\n\"type\":\"ranking_player\",\n\"user_id\": user_id\n}\n```\n\n## Como citar este conteúdo\n\n```latex\nDE SOUZA, Edson Melo (2022, October 6). PHP API GAMES v.1.0.\nAvailable in: https://github.com/EdsonMSouza/apigames\n```\n\nOu BibTeX for LaTeX:\n\n```latex\n@misc{desouza2022apigame,\n  author = {DE SOUZA, Edson Melo},\n  title = {PHP API GAMES v.1.0},\n  url = {https://github.com/EdsonMSouza/apigames},\n  year = {2022},\n  month = {October}\n}\n```\n\n## Licença\n\n[![CC BY-SA 4.0][cc-by-sa-shield]][cc-by-sa]\n\nEste trabalho é licenciado sob a\n[Creative Commons Attribution-ShareAlike 4.0 International License][cc-by-sa].\n\n[![CC BY-SA 4.0][cc-by-sa-image]][cc-by-sa]\n\n[cc-by-sa]: http://creativecommons.org/licenses/by-sa/4.0/\n\n[cc-by-sa-image]: https://licensebuttons.net/l/by-sa/4.0/88x31.png\n\n[cc-by-sa-shield]: https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedsonmsouza%2Fapigames","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedsonmsouza%2Fapigames","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedsonmsouza%2Fapigames/lists"}