Every API here is available over the APIs.io API and to AI agents over MCP.
{
"openapi": "3.1.0",
"info": {
"title": "Palmistry Service API",
"description": "API for Palmistry Service - AI Power Palm Reading",
"version": "1.0.0"
},
"paths": {
"/predict": {
"post": {
"tags": [
"Prediction"
],
"summary": "Predict Base64",
"operationId": "predict_base64_predict_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PredictRequestBase64"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/predict": {
"post": {
"tags": [
"Prediction"
],
"summary": "Api Predict Url",
"operationId": "api_predict_url_api_predict_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PredictRequestUrl"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/get-palm-image": {
"post": {
"tags": [
"Prediction"
],
"summary": "Api Processed Palm",
"operationId": "api_processed_palm_palmistry_get_palm_image_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PredictRequestPalmID"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/basic": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Palm Scanner Basic",
"description": "Generates a basic palm reading report from an image URL.\n\nArgs:\n data (PalmReadingRequest): The request body containing 'image_url' or 'url'.\n service: The palm reading service dependency.\n\nReturns:\n dict: The basic palm reading result.",
"operationId": "palm_scanner_basic_palmistry_basic_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmReadingRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/get-palm-id": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Palm Scanner",
"description": "Generates a professional palm reading report and saves it to the database.\n\nArgs:\n data (PalmReadingRequest): The request body containing 'image_url' or 'url'.\n service: The palm reading service dependency.\n\nReturns:\n dict: The pro palm reading result including the database reading ID.",
"operationId": "palm_scanner_palmistry_get_palm_id_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmReadingRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/hand-type": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Hand Type",
"description": "Retrieves the hand type for a specific reading.",
"operationId": "get_hand_type_palmistry_hand_type_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/fingers": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Fingers",
"description": "Retrieves the fingers analysis for a specific reading.",
"operationId": "get_fingers_palmistry_fingers_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/major-lines": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Major Lines",
"description": "Retrieves the major lines analysis for a specific reading.",
"operationId": "get_major_lines_palmistry_major_lines_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/mounts": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Mounts",
"description": "Retrieves the mounts analysis for a specific reading.",
"operationId": "get_mounts_palmistry_mounts_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/special-features": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Special Features",
"description": "Retrieves the special features analysis for a specific reading.",
"operationId": "get_special_features_palmistry_special_features_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/minor-lines": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Minor Lines",
"description": "Retrieves the minor lines analysis for a specific reading.",
"operationId": "get_minor_lines_palmistry_minor_lines_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/summary": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Summary",
"description": "Retrieves the summary for a specific reading.",
"operationId": "get_summary_palmistry_summary_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/personality": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Personality",
"description": "Generates AI-powered personality analysis for a specific palm reading.",
"operationId": "get_personality_palmistry_personality_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/career": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Career",
"description": "Generates AI-powered career analysis for a specific palm reading.",
"operationId": "get_career_palmistry_career_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/money": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Money",
"description": "Generates AI-powered money/finance analysis for a specific palm reading.",
"operationId": "get_money_palmistry_money_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/love": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Love",
"description": "Generates AI-powered love life analysis for a specific palm reading.",
"operationId": "get_love_palmistry_love_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/marriage": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Marriage",
"description": "Generates AI-powered marriage analysis for a specific palm reading.",
"operationId": "get_marriage_palmistry_marriage_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/health": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Health",
"description": "Generates AI-powered health analysis for a specific palm reading.",
"operationId": "get_health_palmistry_health_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/challenges": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Challenges",
"description": "Generates AI-powered life challenges analysis for a specific palm reading.",
"operationId": "get_challenges_palmistry_challenges_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/luck": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Get Luck",
"description": "Generates AI-powered luck & fortune analysis for a specific palm reading.",
"operationId": "get_luck_palmistry_luck_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmIDRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/palmistry/legacy": {
"post": {
"tags": [
"Palm Reading"
],
"summary": "Palm Scanner Legacy",
"description": "Backward-compatible palm reading (defaults to basic).",
"operationId": "palm_scanner_legacy_palmistry_legacy_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PalmReadingRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/": {
"get": {
"summary": "Read Root",
"operationId": "read_root__get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
}
},
"components": {
"schemas": {
"HTTPValidationError": {
"properties": {
"detail": {
"items": {
"$ref": "#/components/schemas/ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
},
"PalmIDRequest": {
"properties": {
"palm_id": {
"type": "string",
"title": "Palm Id"
}
},
"type": "object",
"required": [
"palm_id"
],
"title": "PalmIDRequest"
},
"PalmReadingRequest": {
"properties": {
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
},
"img_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Img Url"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image"
},
"day": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Day"
},
"month": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Month"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Year"
},
"gender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Gender"
}
},
"type": "object",
"title": "PalmReadingRequest"
},
"PredictRequestBase64": {
"properties": {
"image_url": {
"type": "string",
"title": "Image Url"
}
},
"type": "object",
"required": [
"image_url"
],
"title": "PredictRequestBase64"
},
"PredictRequestPalmID": {
"properties": {
"palm_id": {
"type": "string",
"title": "Palm Id"
}
},
"type": "object",
"required": [
"palm_id"
],
"title": "PredictRequestPalmID"
},
"PredictRequestUrl": {
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
}
},
"type": "object",
"title": "PredictRequestUrl"
},
"ValidationError": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
},
"input": {
"title": "Input"
},
"ctx": {
"type": "object",
"title": "Context"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
}
}
}
}