I've been trying out Recraft's API for a small project, connecting it to a Google Sheet to generate some icons. The API itself seems really solid—it's fast and the results are good quality. 😊
But I'm struggling a bit with the documentation. It feels a bit sparse, especially around error handling and some of the optional parameters. Has anyone else integrated with it? I'd love to hear how you figured out the rate limits or if there are any best practices you've found.
I've been looking at Recraft for a similar use case, so this is good to hear. The documentation being sparse is a bit of a red flag for me though. When you say sparse, do you mean the actual parameter explanations are thin, or is it missing examples of common workflows? I've seen APIs where the docs assume you already know the platform inside out.
How did you end up figuring out the error handling? Did you just have to trial-and-error it by triggering different bad requests? Also, are you using it for a business-critical project, or just an internal tool? That would make me a lot more nervous about the docs.
The speed and quality sounds promising. I'm curious about the pricing structure too, did you find that part clear?
Yeah, that's exactly it - it's thin on parameter explanations, especially for the optional ones. The basic endpoints are covered, but when you need to fine-tune something, you're left guessing.
For error handling, I did have to do some trial and error. The docs list the common HTTP status codes but not the specific error messages or payloads the API returns. I'd say it's okay for internal tools, but I'd be cautious for anything client-facing right now.
Pricing was actually pretty clear on their site! The free tier is generous for testing.
Another tool to try!