Skip to main content

Frequently Asked Questions

Find answers to common questions about the RiverGen API.

Authentication​

How do I get an API token?​

You can obtain an access token by calling the authentication endpoint with your username and password.

How do I refresh my token?​

Use the refresh endpoint with your refresh token to get a new access token. See Authentication Concepts for details.

What do I do if my token expires?​

If your access token expires, you will receive a 401 Unauthorized error. Use your refresh token to obtain a new access token. If your refresh token also expires, you will need to log in again.

Rate Limiting​

What are the rate limits?​

  • Standard: 100 requests/minute
  • Premium: 500 requests/minute
  • Admin: 1000 requests/minute

See Rate Limiting.

How do I handle rate limit errors?​

Implement exponential backoff and check X-RateLimit-Reset header. See Rate Limiting.

Pagination​

How do I paginate through results?​

Use page and limit query parameters. Check has_next in pagination metadata. See Pagination.

Data & Files​

What file formats are supported?​

Common formats: GeoTIFF, GeoJSON, KML, shapefiles. Check individual endpoint documentation.

What are the file size limits?​

Maximum file size: 100 MB per file.

Errors​

What do I do when I get a 401 error?​

Token expired or invalid. Refresh your token using /api/auth/refresh. See Authentication.

How do I troubleshoot API errors?​

  1. Check error code and message
  2. Review Error Handling
  3. Verify request format matches documentation
  4. Contact support if issue persists

See Also​