Go API client FAQ

If you’re facing connectivity issues, here are some checks you should perform on your side before contacting our support team:

• Are you using the correct application ID and API key? You can find these credentials on your Algolia dashboard.
• Did anything recently change in your code or on your data center provider’s side? Make sure to check their status too.
• Using Firebase? The Firebase free plan only allows requests to other Google APIs. Because of this limitation, you can only use Algolia with Firebase if you’re on a paid Firebase tier.

If you’re unable to debug the problem yourself, please contact the support team with the following information:

• API client and version (e.g., JavaScript API client 4.3.0)
• Language and version (e.g., PHP 7.1)
• Code snippet to reproduce the issue
• Error message or stack trace (if applicable)
• The Algolia index name with which you’re experiencing issues
• The precise timeline (in the UTC time zone of the event)
• Having trouble connecting to the Algolia API from your servers? Send us the link generated by the diagnostic script command on your impacted servers:
  Shell

  Copy

  1
  curl -sL https://algolia.com/downloads/diag.sh > ./diag.sh && sudo ./diag.sh ApplicationID
  

  Ensure that you replace “ApplicationID” with your actual Algolia Application ID.

• Having trouble connecting to the Algolia API from your browser? Head over to community.algolia.com/diag/ and send us this output instead.

You can check out our changelog page.

You’re getting this error because there’s a size limit for records. Make sure you reduce your records and try again.

If you need to get an object from your index, you should use the getObjects method.

You should only use findObject to debug the relevance of a specific object, and in development mode. This method accepts a condition and returns the first matching object along with its position information in the result set. Note that the result set is limited to a certain amount of records, not the entire index.

You must add at least one restriction to generate a valid secured API key. If there are no restrictions, there’s no point in hiding the original API key since the generated secured API key has the same permissions and constraints.

You can find the list of possible restrictions.

When an index doesn’t exist, and you’re using the replaceAllObjects with the safe parameter, the method can get stuck and hang forever. This happens because the method expects the index to exist.

To fix this issue, you can either create the index using the Algolia dashboard, or with the API using an empty setSettings.

If you’ve performed replaceAllObjects, it may still be in progress. If you suspect that the operation didn’t complete successfully and left a temporary index, make sure to double-check the number of records of the temporary index.

If the number of records of the temporary index doesn’t change for 10 minutes, there’s a chance the operation didn’t finish because of an error while indexing records in the temporary index. To debug this, we recommend you check the logs in your Algolia dashboard for the temporary index and see if you find any errors.

Besides, you may also be able to debug the issue in your development console or logging platform.

If you’re unable to debug the problem yourself, please contact the support team with the following information:

• API client and version (e.g., Go client 3.4.0)
• Language and version (e.g., Java 1.8)
• Code snippet to reproduce the issue
• Error message or stack trace (if applicable)
• The Algolia index name with which you’re experiencing issues
• The precise timeline (in the UTC time zone of the event)

This issue may happen when indexing a large number of records, and because of the asynchronous nature of Algolia. You can fix this issue with the safe parameter.

If you need to index many records, you may want to process replaceAllObjects in the background, as the safe parameter may cause the operation to take longer than expected.

The most convenient way is to use the deleteBy method, as it enables you to delete one or more objects based on filters (numeric, facet, tag or geo queries).

The Algolia APIs support cross-origin requests. If you’re getting such an error when indexing or searching, first make sure that your application ID is correct. An incorrect application ID results in querying an endpoint that doesn’t exist, thus resulting in the error.

If the issue persists despite correct credentials, please reach out to Algolia support.

To see the actual request and response payloads between your application and the Algolia servers, you can wrap the Algolia method calls with debug.Enable() and debug.Disable(), such as:

1
2
3
4
5
var yourRecords []Record

debug.Enable()
res, err := index.SaveObjects(yourRecords)
debug.Disable()

Keep in mind that those debug outputs come with a certain runtime overhead. This happens because of the interception and logging of the payloads, which are no longer streamed. Avoid leaving those debugging calls in your production code.

If you haven’t already, you can make your project module-compatible with the following command:

1
go mod init <YOUR_PROJECT_NAME>

This generates a go.mod file, declaring your project as a new module.

You can then download the Algolia Go library with the following go get command:

1
go get github.com/algolia/algoliasearch-client-go/v3@v3.Y.Z

Make sure to respectively replace Y and Z with the minor and patch version of the library that you’d like to download.