3
4
Fork
You've already forked docs
9

add note about correct server ID to use for API calls #13

Open
tetov wants to merge 1 commit from tetov/servfail-docs:api_use_soa into meow
pull from: tetov/servfail-docs:api_use_soa
merge into: servfail:meow
servfail:meow
servfail:frog
Contributor
Copy link

Found out this will setting up caddy dns.providers.powerdns and thought it would be good to document :)

Found out this will setting up [caddy dns.providers.powerdns](https://caddyserver.com/docs/modules/dns.providers.powerdns) and thought it would be good to document :)
Author
Contributor
Copy link

And my editor ate some trailing whitespace, sorry not sorry.

And my editor ate some trailing whitespace, sorry not sorry.
content/api.md Outdated
@ -28,3 +28,3 @@
- `/api/v1/servers/{server}/zones/{zone}/{action}`
`{server}` is one of our NSes (including the canonical trailing dot) and `{zone}` is your domain (also with the canonical dot). Some PowerDNS libraries strip the canonical dot from the URL, which is accepted by PowerDNS itself, but not by our API proxy; Work on creating a fix for this is already underway.
`{server}` should be your main nameserver (your [SOA](@/basics.md#SOA)) including the canonical trailing dot. `{zone}` is your domain (also with the canonical dot). Some PowerDNS libraries strip the canonical dot from the URL, which is accepted by PowerDNS itself, but not by our API proxy; Work on creating a fix for this is already underway.
Owner
Copy link

I'd change this to say something along the lines of "the nameserver you choose as your primary while adding the domain". The SOA is a consequence of that, I guess that is a nice reference in case someone forgets.

I'd change this to say something along the lines of "the nameserver you choose as your primary while adding the domain". The SOA is a consequence of that, I guess that is a nice reference in case someone forgets.
Author
Contributor
Copy link

I updated the text to

{server} should be the nameserver you chose as your primary when you added your domain (check your SOA), including the canonical trailing dot.

😸

I updated the text to > `{server}` should be the nameserver you chose as your primary when you added your domain (check your [SOA](@/basics.md#SOA)), including the canonical trailing dot. 😸
famfo marked this conversation as resolved
@ -50,0 +51,4 @@
```sh
export server=miyuki.sakamoto.pl.
export zone=sdomi.pl.
Owner
Copy link

Please use example domains for documentation (for example example.com or from the .example TLD).

Please use example domains for documentation (for example `example.com` or from the `.example` TLD).
This pull request can be merged automatically.
This branch is out-of-date with the base branch
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u api_use_soa:tetov-api_use_soa
git switch tetov-api_use_soa

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch meow
git merge --no-ff tetov-api_use_soa
git switch tetov-api_use_soa
git rebase meow
git switch meow
git merge --ff-only tetov-api_use_soa
git switch tetov-api_use_soa
git rebase meow
git switch meow
git merge --no-ff tetov-api_use_soa
git switch meow
git merge --squash tetov-api_use_soa
git switch meow
git merge --ff-only tetov-api_use_soa
git switch meow
git merge tetov-api_use_soa
git push origin meow
Sign in to join this conversation.
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
servfail/docs!13
Reference in a new issue
servfail/docs
No description provided.
Delete branch "tetov/servfail-docs:api_use_soa"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?