Verify playstore application by name

Summary

• Source repository: jef-systems/jef-playstore-backend

• Source SHA: eb793550a12d9e11927e529c3cd85e40d94c5421

• Source run id: 29434262589

• Module: Playstore

• Lambda function: jef-playstore-verify-application-by-name

• HTTP method: POST

• Invocation mode: sync

• Package mode: no-package

• API category: Playstore Complex Sync No Package POST APIs

• API path: /playstore/complex-sync-no-packages/jef-playstore-verify-application-by-name

• Endpoint URL: https://api.jefoffice.com/playstore/complex-sync-no-packages/jef-playstore-verify-application-by-name

• Documentation scope: lambda-complex-sync-no-packages

Synchronous Lambda Complex Rule

This API is documented as a synchronous Lambda complex no-package API. API Gateway waits for the Lambda result and returns the final Lambda response.

Description

POST endpoint that verifies whether one domain-scoped jef-playstore application exists by display name.

Payload Example

{
  "domain_name": "jefstore",
  "name": "JEF Playstore"
}

Payload Schema

{
  "root": {
    "type": "M",
    "required": true,
    "attributes": {
      "domain_name": {
        "type": "S",
        "required": true,
        "regex": "^[a-z0-9][a-z0-9.-]{1,120}$"
      },
      "domain_id": {
        "type": "S",
        "required": false,
        "format": "uuidv4",
        "validation": "must_match_resolved_domain_id_when_domain_name_is_supplied"
      },
      "name": {
        "type": "S",
        "required": true,
        "regex": "^[A-Za-z0-9 ._@:/#,+&()_-]{1,160}$"
      }
    }
  },
  "notes": [
    "domain_name is required unless domain_id is supplied.",
    "domain_id is not trusted by itself when domain_name is supplied; it must match the resolved domain.",
    "package_name is intentionally not accepted because this function verifies by display name only.",
    "The lookup is domain-scoped and read-only."
  ]
}

Response Schema

{
  "root": {
    "type": "M",
    "required": true,
    "attributes": {
      "is_accepted": {
        "type": "BOOL",
        "required": true
      },
      "exists": {
        "type": "BOOL",
        "required": true
      },
      "is_verified": {
        "type": "BOOL",
        "required": true
      },
      "ok": {
        "type": "BOOL",
        "required": false
      },
      "retryable": {
        "type": "BOOL",
        "required": false
      },
      "repair_required": {
        "type": "BOOL",
        "required": false
      },
      "message_type": {
        "type": "S",
        "required": true
      },
      "message": {
        "type": "S",
        "required": true
      },
      "operation": {
        "type": "S",
        "required": true
      },
      "status_code": {
        "type": "N",
        "required": true
      },
      "domain_id": {
        "type": "S",
        "required": false
      },
      "domain_name": {
        "type": "S",
        "required": false
      },
      "domain_lookup_source": {
        "type": "S",
        "required": false
      },
      "application_id": {
        "type": "S",
        "required": false
      },
      "package_name": {
        "type": "S",
        "required": false
      },
      "name": {
        "type": "S",
        "required": false
      },
      "version": {
        "type": "S",
        "required": false
      },
      "version_code": {
        "type": "N",
        "required": false
      },
      "is_mobile": {
        "type": "BOOL",
        "required": false
      },
      "apk_s3_uri": {
        "type": "S",
        "required": false
      },
      "apk_cloudfront_url": {
        "type": "S",
        "required": false
      },
      "apk_object_key": {
        "type": "S",
        "required": false
      },
      "apk_sha256": {
        "type": "S",
        "required": false
      },
      "signing_certificate_sha256": {
        "type": "S",
        "required": false
      },
      "apk_size_bytes": {
        "type": "N",
        "required": false
      },
      "build_type": {
        "type": "S",
        "required": false
      },
      "source_sha": {
        "type": "S",
        "required": false
      },
      "failure_code": {
        "type": "S",
        "required": false
      },
      "failure_reason": {
        "type": "S",
        "required": false
      },
      "match_count": {
        "type": "N",
        "required": false
      },
      "item": {
        "type": "M",
        "required": false,
        "attributes": {
          "application_id": {
            "type": "S",
            "required": true
          },
          "domain_id": {
            "type": "S",
            "required": true
          },
          "package_name": {
            "type": "S",
            "required": true
          },
          "name": {
            "type": "S",
            "required": true
          },
          "version": {
            "type": "S",
            "required": true
          },
          "version_code": {
            "type": "N",
            "required": false
          },
          "is_mobile": {
            "type": "BOOL",
            "required": true
          },
          "apk_s3_uri": {
            "type": "S",
            "required": false
          },
          "apk_cloudfront_url": {
            "type": "S",
            "required": false
          },
          "apk_object_key": {
            "type": "S",
            "required": false
          },
          "apk_sha256": {
            "type": "S",
            "required": false
          },
          "signing_certificate_sha256": {
            "type": "S",
            "required": false
          },
          "apk_size_bytes": {
            "type": "N",
            "required": false
          },
          "build_type": {
            "type": "S",
            "required": false
          },
          "source_sha": {
            "type": "S",
            "required": false
          },
          "created": {
            "type": "S",
            "required": true
          },
          "updated": {
            "type": "S",
            "required": true
          }
        }
      },
      "matches": {
        "type": "L",
        "required": false
      },
      "domain": {
        "type": "M",
        "required": false
      }
    }
  },
  "notes": [
    "A successful verification returns one matching application item, including APK metadata when available.",
    "Domain lookup falls back to deterministic domain_id after a recent idempotent domain create.",
    "A 404 not_found response means the domain was valid but no application name matched.",
    "A 409 duplicate_application_name response means more than one application in the same domain has the same name.",
    "This endpoint verifies the DynamoDB application record only and does not claim that the live APK was cryptographically verified."
  ]
}

Request Payload

{
  "domain_name": "jefstore",
  "name": "JEF Playstore"
}

CMD curl

curl.exe -X POST "https://api.jefoffice.com/playstore/complex-sync-no-packages/jef-playstore-verify-application-by-name" -H "Content-Type: application/json" --data-raw '{}'

PowerShell curl

curl.exe -X POST "https://api.jefoffice.com/playstore/complex-sync-no-packages/jef-playstore-verify-application-by-name" -H "Content-Type: application/json" --data-raw '{}'