Stay organized with collections
Save and categorize content based on your preferences.
Once you have exchanged keys with Google and have your vendor ID (PIAID), you
are ready to establish connectivity with the Redirect FOP API is to
and complete a successful echo test. We provide
code samples to help you perform these tests
using the encryptions keys we exchange to ensure your configuration is correct
and that your infrastructure is properly routing our requests to your host.
Once you have successfully completed echo tests using one of our code
samples, you can update your implementation to communicate with our APIs.
Echo from Partner to Google
Google hosts an echo endpoint
which you can call to test your ability to successfully communicate with our
servers. You should use the encryption keys you exchanged with Google when
forming your echo request and parsing our response.
Using our code samples to echo Google
Once you have one of our code samples configured
and running, you can trigger an echo request to Google by using curl or a
similar tool as follows:
If your keys are properly set up, you should see a successful echo response.
Echo request code samples
Debugging errors during initial development to establish connectivity can be
difficult since our API returns 404s for requests with PGP encryption errors.
And, all responses are encrypted and sent as an octet-stream, which can further
complicate initial connectivity work.
There are a number of resources to help you get started:
Sample code showing how to successfully perform bidirectional echo tests
Codelabs that walk through our code samples
Code sample downloads
The following code samples are fully working examples that can call the Google
hosted echo API. Note that the samples also include code for hosting your
own echo endpoint. The Redirect FOP API does not need that
capability so you should focus your attention on the echo request to Google's
endpoint.
The following codelabs walk through our Java and Node.js sample implementations
to help you quickly come up to speed with how they work and the key
configuration settings you need to adjust to get them working.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-03 UTC."],[[["After exchanging keys with Google and obtaining your vendor ID, you can establish connectivity with the Redirect FOP API by completing a successful echo test."],["Google provides code samples in Java and Node.js to help you perform echo tests using the exchanged encryption keys, ensuring correct configuration and infrastructure setup."],["You can trigger an echo request to Google's endpoint using tools like `curl` after setting up the code samples."],["Google offers codelabs and a Java implementation for encryption and decryption to aid in debugging and understanding the process."],["The provided code samples demonstrate bidirectional echo tests and include code for hosting your own echo endpoint, although this capability isn't needed for the Redirect FOP API."]]],["After exchanging keys with Google and obtaining a vendor ID, you can establish connectivity with the Redirect FOP API. Utilize the provided code samples (Java/Node.js) to perform an echo test with Google's echo endpoint, employing the exchanged encryption keys. Send a POST request (e.g., `curl -H \"Content-type: text/plain\" -X POST -d 'hello' https://{YOUR_HOST}/echo`) to the endpoint. Successful completion of this test, with no 404 errors, indicates proper key setup and connectivity. The provided code samples include functionalities for both sending and receiving echo requests. Codelab walkthroughs are also available.\n"]]