Errors respond with an error code and JSON that contains a more precise message, description and API code. Either there is something wrong with your request or something went wrong on our end. When you make an API call you may receive an error message in response. If your account has been suspended due to concern about a possible violation of our Messaging Policy, please reply to the email you should have received from you have not received this email, you can still contact the Compliance team directly through the app. Sandbox Domain Limits: The sandbox sending domain ( ) is limited to 5 emails for the lifetime of your account. Process will be more efficient than polling message events and avoids rate limiting. If your application requires low latency access to each event, using a webhook-based For example, a single call to the metrics deliverability summaryĮndpoint offers a summary of deliveries, bounces, opens, clicks, and more for some time period. Alternatives To Pollingįor some common use cases, the API offers more efficient alternatives to polling, especially of the Events endpoint. Some customers may have daily or monthly sending limits which may trigger a 420. The Transmissions API POSTs are not rate-limited in this way although DELETE requests are. Heavier usage patterns may require a more sophisticated and incremental backoff strategy. These limits are dynamic, but as a general rule, wait 1 to 5 seconds after receiving a 429 response before requesting again. If you exceed the limits for an API you will receive an HTTP status code 429. SparkPost APIs are rate limited, which limits how often each user can call the API, in order to protect the service from inadvertent or malicious overuse. This documentation is meant to serve as reference for all accounts, from Developer to Enterprise.įeatures that are limited to some accounts will be marked appropriately throughout as: SparkPost presents a unified core API to all users with a few noted exceptions. When relevant, EU specific links and information will be provided alongside general information. All documentation here works for both services. SparkPostĪnd SparkPost EU accounts operate independently.Īn account created in SparkPost cannot be used in SparkPost EU, and vice-versa.
Spark post full#
SparkPost EU is the full SparkPost service hosted in Western Europe. Our JSON number type is bounded to a signed 32-bit integer. Unexpected query parameters and request body fields are ignored. The HTTP status indicates whether an operation failed or succeeded, with extra information included in the HTTP response body.Īll APIs return standard HTTP error code formats. Query parameters and JSON fields use lower case, with underscores separating words. URL paths use lower case, with dashes separating words. URL paths, URL query parameter names, and JSON field names are case sensitive. Trailing slashes are ignored: /transmissions is equivalent to /transmissions/.
0 kommentar(er)
