I've just added documentation for all the public APIs here: https://perchance.org/advanced-tutorial Thanks!
this post was submitted on 01 Sep 2024
2 points (100.0% liked)
Perchance - Create a Random Text Generator
391 readers
7 users here now
⚄︎ Perchance
This is a Lemmy Community for perchance.org, a platform for sharing and creating random text generators.
Feel free to ask for help, share your generators, and start friendly discussions at your leisure :)
This community is mainly for discussions between those who are building generators. For discussions about using generators, especially the popular AI ones, the community-led Casual Perchance forum is likely a more appropriate venue.
See this post for the Complete Guide to Posting Here on the Community!
Rules
1. Please follow the Lemmy.World instance rules.
- The full rules are posted here: (https://legal.lemmy.world/)
- User Rules: (https://legal.lemmy.world/fair-use/)
2. Be kind and friendly.
- Please be kind to others on this community (and also in general), and remember that for many people Perchance is their first experience with coding. We have members for whom English is not their first language, so please be take that into account too :)
3. Be thankful to those who try to help you.
- If you ask a question and someone has made a effort to help you out, please remember to be thankful! Even if they don't manage to help you solve your problem - remember that they're spending time out of their day to try to help a stranger :)
4. Only post about stuff related to perchance.
- Please only post about perchance related stuff like generators on it, bugs, and the site.
5. Refrain from requesting Prompts for the AI Tools.
- We would like to ask to refrain from posting here needing help specifically with prompting/achieving certain results with the AI plugins (
text-to-image-pluginandai-text-plugin) e.g. "What is the good prompt for X?", "How to achieve X with Y generator?" - See Perchance AI FAQ for FAQ about the AI tools.
- You can ask for help with prompting at the 'sister' community Casual Perchance, which is for more casual discussions.
- We will still be helping/answering questions about the plugins as long as it is related to building generators with them.
6. Search through the Community Before Posting.
- Please Search through the Community Posts here (and on Reddit) before posting to see if what you will post has similar post/already been posted.
founded 1 year ago
MODERATORS
Ah great! I just noticed this but the apis on that tutorial page only just showed up. I'll be trying them out!
I don't suppose you could add an id to that <h2> could you? So we can link people direct to that section? 😉
Done, thanks!
👍
The endpoint for getting the generator stats/metadata is https://perchance.org/api/getGeneratorStats?names={names}, it would return a list of data based on the generator names inputted and it would give a metadata property per generator that you can access.
Here is an example of using it: https://perchance.org/generator-list-with-stats-2-template#edit
Ah cool... thanks!
Do you know if there's anywhere documenting /api/? Or at least listing endpoints/params so I can test and write my own docs for it?
No, I don't think there is. The public ones that I've seen are:
api/getGeneratorScreenshot?generatorName=name- for generator screenshotsapi/getGeneratorList?max=num- for the general generator list in the/generatorspageapi/getGeneratorStats?names=name1,name2- for individual stats as seen from https://perchance.org/generator-list-with-stats-2-template#editapi/downloadGenerator?generatorName=name- from the download-button-plugin
Great thanks!
And of course with the new tags $meta property, there's also api/getGeneratorList?tags=foo ref