There are function in the library for getting an auth record, which includes an auth token and a refresh token.

There are rules around how long each are good... I think the auth token is a month but the refresh token is 6 months maybe?

Might want to add a function that allows the refresh token to be used to refresh the auth token.

There's a short form for tags and authors, but supporting it in C# is more complicated than in JavaScript, where the types are made up and the fields don't matter.

You can link tags and authors to any post you create in the same request body, using either short or long form to identify linked resources.

Short form uses a single string to identify a tag or author resource. Tags are identified by name and authors are identified by email address:

{
    "posts": [{
        "title": "My test post",
        "tags": ["Getting Started", "Tag Example"],
        "authors": ["[email protected]", "[email protected]"]
    }]
}

I didn't implement it yet, but if there was a strong reason to, then I'd do something about it... maybe.

The RestResponse.Content field looks something like this when it has an error in it, when it's returned in GhostAPI.cs. I could modify the error I return to take some of that data into account, to make errors more meaningful...

{
	"errors": [{
		"message": "Validation error, cannot save post.",
		"context": "Validation failed for 'posts'",
		"type": "ValidationError",
		"details": [{
				"keyword": "additionalProperties",
				"dataPath": "",
				"schemaPath": "#/additionalProperties",
				"params": {
					"additionalProperty": "Posts"
				},
				"message": "should NOT have additional properties"
			},
			{
				"keyword": "required",
				"dataPath": "",
				"schemaPath": "#/required",
				"params": {
					"missingProperty": "posts"
				},
				"message": "should have required property 'posts'"
			}
		],
		"property": "posts",
		"help": null,
		"code": null,
		"id": "b50a7fd0-500a-11e9-a8e0-472301ed00b2"
	}]
}




{
	"errors": [{
		"message": "Validation error, cannot edit post.",
		"context": "Validation failed for 'posts[0]'",
		"type": "ValidationError",
		"details": [{
			"keyword": "additionalProperties",
			"dataPath": ".posts[0]",
			"schemaPath": "#/additionalProperties",
			"params": {
				"additionalProperty": "uuid"
			},
			"message": "should NOT have additional properties"
		}, {
			"keyword": "additionalProperties",
			"dataPath": ".posts[0]",
			"schemaPath": "#/additionalProperties",
			"params": {
				"additionalProperty": "comment_id"
			},
			"message": "should NOT have additional properties"
		}],
		"property": "posts[0]",
		"help": null,
		"code": null,
		"id": "1ba48e70-5155-11e9-be0e-1702dc9d57c3"
	}]
}

Address CodeFactor issues.

The build process throws the following warning:

'HMACSHA256Algorithm' is obsolete: 'HMAC SHA based algorithms are not secure to protect modern web applications. Consider switching to RSASSA or ECDSA.'

Not sure if this is a valid issue for this library, but it'd be good to check into.

https://ghost.org/docs/admin-api/#token-generation

This snippet of code:

Is now natively supported in .NET 5 and up through:

Convert.FromHexString()

See:
https://learn.microsoft.com/en-us/dotnet/api/system.convert.fromhexstring?view=net-6.0&WT.mc_id=DOP-MVP-5001511

Scour the documentation for other notes, edge-cases I didn't support.

There's likely stuff in there I missed. 🤷‍♂️

Take a look at the other Ghost-SDK files to see if I missed anything in my implementation of things...

• https://github.com/TryGhost/Ghost-SDK/tree/master/packages
• https://github.com/TryGhost/Ghost-SDK/blob/master/packages/admin-api/lib/index.js
• https://github.com/TryGhost/Ghost-SDK/blob/master/packages/content-api/lib/index.js

Ref: #17

Consider replacing NUnit with xUnit, which was created by the same author but seems to be more extensible and runs tests more isolated (per test instead of per class).

Comparison:
https://dingyuliang.me/unit-testing-frameworks-xunit-vs-nunit-vs-mstest-net-net-core/

https://docs.ghost.org/api/content/

Most fields, like Html, PlainText, CustomExcerpt, CreatedTime, etc., should be transferred when creating a post, but they're not.

In fact, the Title is one of the few pieces that does transfer correctly.

also see: CreatePostTests.CreatePost_ReturnsPost_WhenPostCreated()

Looks like "themes" is now stable - uploading, activating.

https://ghost.org/docs/api/v3/admin/#endpoints

Unfortunately, they provide no examples for it, so it's "stable" but doesn't seem to be supported yet. ?? (Same as of Sept 21)

• https://github.com/HexRweb/ghost-deploy/blob/2.0.0/actions/activate-theme.js
• https://github.com/HexRweb/ghost-deploy/tree/2.0.0/actions
• https://forum.ghost.org/t/uploading-a-theme-via-the-admin-api/12249

Right now, you can create a single post or tag at a time.

It wouldn't take a tremendous amount of effort to allow multiple posts/tags, but it would involve some refactoring and more tests.

I am planning to use GhostSharp as a dependency for a statistic site I am building using dotnetcore.

Unfortunately, GhostSharp is not yet available in NuGet.

I have already forked the repo and I am planning to put automatic versioning release to Nuget.

Will keep you posted.

Regards,
Rene

By the way, @grantwinney nice work

Even when setting a post to be "scheduled" with a valid scheduled date in the future, setting the send_email_when_published field (via query parameter) doesn't work.

Comments in Ghost codebase:

https://github.com/TryGhost/Ghost/blob/5b471e1bbe6f60db518726f4ea697562ae5a2f4a/core/server/models/post.js#L480

Need to support count.posts, which returns a count of posts with the tag. Currently the library does nothing with this, mainly because I didn't understand it at first.

see: https://api.ghost.org/docs/tag

Consider creating interfaces for all classes, to make it easier for others to mock things out (i.e. using the moq library) during testing.

Easiest to do this once I'm sure the library reasonably covers most of the Ghost API.

In Endpoints/Admin/Post.cs I'm doing updatedPost.UpdatedAt = originalPost.UpdatedAt; to keep the UpdatedAt the same time. Is this still necessary? Maybe switch it to only prevent an older timestamp?

https://ghost.org/docs/admin-api/#members

It seems like the mobiledoc field of the posts request is something in and of itself, and I don't understand it yet. Need to look at the docs and update library to properly support it.

Updated to the latest version via nuget, but the abovementioned parameters don't change when creating a post(

• finish asserts in above test
• is title ALWAYS required (I think it can't be left blank)?? are all writable fields required even if not changing?? :/
• do a GET and save it right back in?
• Tag and author relations will be replaced, not merged - test this
• which takes precedence if html AND mobiledoc are both updated?
  • need to attach query parameter to specify html, like when creating post?
• should i create a CreatableAttribute too to ignore fields that shouldn't be sent, like id or uuid?
• !! then copy all of this for pages

At some point, I should look through this and see if there's anything I could use in GhostSharp from it.

Ghost-SDK/packages/admin-api-schema/lib/v2 at master · TryGhost/Ghost-SDK

Hi, I don't know if you still maintain this, but I figured it was worth a shot. I am using it and loving it, but I no matter what I do, I never get codeinjection_head back from the getposts or getpostbyid methods. I am getting this by making my own call, but I have made something that means that all my posts has it, so I need it for all of my update calls to not overwrite the values :D

Is there any chance you could get that working? :)

https://github.com/TryGhost/Ghost/blob/master/core/server/data/schema/schema.js

Should probably look closely at the other comments through the codebase, like:

https://github.com/TryGhost/Ghost/blob/master/core/server/models/post.js

Certain endpoints are throwing a 504 gateway exception, but I'm not sure if it's just my site or some other problem.

• Update Offers
• Update Tiers

I think the images endpoint supports uploading multiple files at once. Could research and implement it, but probably won't unless someone asks for it.

This might also be true for themes too... maybe? (In both cases, the response that comes back from the API is a list of images/themes...)

https://forum.ghost.org/t/python-sdk-library-unofficial/6504/3

If the library was updated to work with the new APIs and matched the functionality of our official JS libraries as much as possible we’d be happy to link to it from the docs

My Ghost instance is located at https://mydomain.com/blog/cms. When I try to initialize using this URI, the wrapper won't function.

I'm guessing this is because the RestClient uses https://mydomain.com/ghost/api/v2/content/ as it's Url.