Skip to main content

External System API Reference

This document provides detailed information about the External System API endpoints. All endpoints require API key authentication and the EXTERNAL_SYSTEM role.

Authentication​

All endpoints require:

  • Valid API key in the request header
  • EXTERNAL_SYSTEM role

Endpoints​

Get BlockBet User Information​

Retrieves BlockBet user information based on their Badhombre ID.

POST /external-system/block-bet-info

Request Body​

{
  "badhombreId": "string" // Numeric string representing the Badhombre ID
}

Response​

{
  "blockbetId": "string",
  "blockbetUsername": "string",
  "badhombreId": "string"
}

Transfer Credits​

Transfers credits between BlockBet and Badhombre systems.

POST /external-system/blockpicks/transfer-credits

Request Body​

{
  "blockBetId": "string",    // BlockBet user ID
  "amount": number,          // Amount to transfer
  "currencyCode": "string"   // Currency code for the transfer
}

Response​

Returns the transfer result from the Badhombre API.

Error Responses​

  • 404 Not Found: When the specified BlockBet user is not found
  • 401 Unauthorized: When the API key is invalid or missing
  • 403 Forbidden: When the request doesn't have the required EXTERNAL_SYSTEM role