apiverve / rockpaperscissors

1.2.3 2026-10-26 14:44 UTC

Requires

• php: >=7.4
• guzzlehttp/guzzle: ^7.0

Requires (Dev)

• phpunit/phpunit: ^9.0

MIT

• APIVerve

• api
• apiverve
• rockpaperscissors
• rock paper scissors
• rps game
• game api
• random choice
• game simulator

Published on Packagist.org on 2026-10-26 17:29 UTC

README

Rock Paper Scissors API simulates the classic hand game with detailed outcome analysis, statistics, and support for multiple rounds.

The Rock Paper Scissors API provides a simple, reliable way to integrate rock paper scissors functionality into your applications. Built for developers who need production-ready rock paper scissors capabilities without the complexity of building from scratch.

View API Details →

Available on:

Quick Start

Using JavaScript

async function callRockPaperScissorsAPI() {
    try {
        const params = new URLSearchParams({
            choice: 'rock',
            rounds: 5
        });

        const response = await fetch(`https://api.apiverve.com/v1/rockpaperscissors?${params}`, {
            method: 'GET',
            headers: {
                'x-api-key': 'YOUR_API_KEY_HERE'
            }
        });

        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callRockPaperScissorsAPI();

Using cURL

curl -X GET "https://api.apiverve.com/v1/rockpaperscissors?choice=rock&rounds=5" \
  -H "x-api-key: YOUR_API_KEY_HERE"

Get your API key: https://apiverve.com

📁 For more examples, see the examples folder

Installation

Choose your preferred programming language:

📦 NPM (JavaScript/Node.js)

npm install @apiverve/rockpaperscissors

View NPM Package → | Package Code →

🔷 NuGet (.NET/C#)

dotnet add package APIVerve.API.RockPaperScissors

View NuGet Package → | Package Code →

🐍 Python (PyPI)

pip install apiverve-rockpaperscissors

View PyPI Package → | Package Code →

💎 Ruby (RubyGems)

gem install apiverve_rockpaperscissors

View RubyGems Package → | Package Code →

🐘 PHP (Packagist)

composer require apiverve/rockpaperscissors

View Packagist Package → | Package Code →

🎯 Dart (pub.dev)

dart pub add apiverve_rockpaperscissors

View pub.dev Package → | Package Code →

🤖 Android (JitPack)

implementation 'com.github.apiverve:rockpaperscissors-api:1.0.0'

Package Code →

🐹 Go

go get github.com/apiverve/rockpaperscissors-api/go

Package Code →

Why Use This API?

Feature	Benefit
Multi-language SDKs	Native packages for JavaScript, Python, C#, Go, and Android
Simple Integration	Single API key authentication, consistent response format
Production Ready	99.9% uptime SLA, served from 24 global regions
Comprehensive Docs	Full examples, OpenAPI spec, and dedicated support

Documentation

• 🏠 API Home: Rock Paper Scissors API
• 📚 API Reference: docs.apiverve.com/ref/rockpaperscissors
• 📖 OpenAPI Spec: openapi.yaml
• 💡 Examples: examples/

What Can You Build?

The Rock Paper Scissors API is commonly used for:

• Web Applications - Add rock paper scissors features to your frontend or backend
• Mobile Apps - Native SDKs for Android development
• Automation - Integrate with n8n, Zapier, or custom workflows
• SaaS Products - Enhance your product with rock paper scissors capabilities
• Data Pipelines - Process and analyze data at scale

API Reference

Authentication

All requests require an API key in the header:

x-api-key: YOUR_API_KEY_HERE

Get your API key: https://apiverve.com

Response Format

Every APIVerve endpoint returns the same envelope — check status, then read data:

{
  "status": "ok",
  "error": null,
  "data": { ... }
}

Example Response

A real response from the Rock Paper Scissors API:

{
  "status": "ok",
  "error": null,
  "data": {
    "total_rounds": 5,
    "player_choice_mode": "manual",
    "games": [
      {
        "round": 1,
        "player_choice": "rock",
        "player_emoji": "🪨",
        "computer_choice": "paper",
        "computer_emoji": "📄",
        "outcome": "computer",
        "message": "Computer wins! undefined"
      },
      {
        "round": 2,
        "player_choice": "rock",
        "player_emoji": "🪨",
        "computer_choice": "rock",
        "computer_emoji": "🪨",
        "outcome": "tie",
        "message": "It's a tie! Both chose rock"
      },
      {
        "round": 3,
        "player_choice": "rock",
        "player_emoji": "🪨",
        "computer_choice": "rock",
        "computer_emoji": "🪨",
        "outcome": "tie",
        "message": "It's a tie! Both chose rock"
      },
      {
        "round": 4,
        "player_choice": "rock",
        "player_emoji": "🪨",
        "computer_choice": "paper",
        "computer_emoji": "📄",
        "outcome": "computer",
        "message": "Computer wins! undefined"
      },
      {
        "round": 5,
        "player_choice": "rock",
        "player_emoji": "🪨",
        "computer_choice": "scissors",
        "computer_emoji": "✂️",
        "outcome": "player",
        "message": "You win! Rock crushes scissors"
      }
    ],
    "results": {
      "player_wins": 1,
      "computer_wins": 2,
      "ties": 2,
      "player_win_percentage": 20,
      "computer_win_percentage": 40,
      "tie_percentage": 40
    },
    "overall_winner": "computer",
    "game_rules": {
      "rock_beats": "scissors",
      "paper_beats": "rock",
      "scissors_beats": "paper"
    }
  }
}

Support & Community

• 🏠 API Home: Rock Paper Scissors API
• 💬 Support: https://apiverve.com/contact
• 🐛 Issues: GitHub Issues
• 📖 Documentation: https://docs.apiverve.com
• 🌐 Website: https://apiverve.com

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Security

For security concerns, please review our Security Policy.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Built with ❤️ by APIVerve

Copyright © 2026 APIVerve. All rights reserved.